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L i s t e d b e l o w a r e c o m m a n d s , s t a t e m e n t s a n d f u n c t i o n s w h i c h f o r m t h e 


c o m m o n c o r e " . 
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. . . 
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. . . 
N E X T 
● 
● 
● 


G E T 
GET$ 
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I F 
. . . 
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(C) Copyright BBC September 1982 Page 2 


4 


N E X T 


N O T 


O N 
E R R O R 


O N 
X G O T O 


O N 
X G O S U B 


O P E N I N 


O P E N O U T 


O R 


P 
I 


P O I N T 


P O S 


P R I N T 


P R I N T # 


R E A D 


R E M 


R E N U M B E R 


R E S T O R E 


R E T U R N 
R I G H T $ 
R N D 


R U N 


S A V E 
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S P C 


S Q R 


S T E P 


S T O P 
STR$ 
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W I D T H 
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k 


r 


E x t e n s i o n s . 


T h e s e e x t e n s i o n s s h o u l d b e a v o i d e d i n s i m p l e p r o g r a m s t h a t a r e 
i n t e n d e d t o b e u s e d o n a v a r i e t y o f m a c h i n e s . 


A C S 


A D V A L 


A S N 


B G E T # 
BPUT# 
C L G 


C O U N T 


D E F 
P R O C 


D E G 


D I V 


E N D P R O C 


E N V E L O P E 


E V A L 
E X T # 
F A L S E 


G C O L 


H I M E M 


L I S T O 


L O C A L 


L O M E M 


M O D E 


O L D 


O P T 


P A G E 


P L O T 


P T R # 
R A D 


R E P E A T 
. . . 
U N T I L 


R E P O R T 


S O U N D 


T I M E 


T O P 


T R U E 


U N T I L 


V D U 
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T h e B A S I C i n t e r p r e t e r w o r k s t h r o u g h o n e o f 
t h e 
c a s s e t t e 
ﬁ l i n g 


t h e 
n e t w o r k 
ﬁ l i n g 
s y s t e m 
( N F S ) 


s y s t e m . 
T h e 
u s e r 


p a s s c o m p l i c a t e d c o m m a n d s d i r e c t t o t h e 
B A S I C o r a n y o t h e r l a n g u a g e o r e n v i r o n m e n t . 


f o u r 
ﬁ l i n g 
s y s t e m s ; 


s y s t e m ( C F S ) , t h e d i s c ﬁ l i n g s y s t e m ( D F S ) , 


o r 
t h e 
R O M 
c a r t r i d g e 
ﬁ l i n g 


c a n e a s i l y m o v e b e t w e e n ﬁ l i n g s y s t e m s a n d c a n 


ﬁ l i n g 
s y s t e m 
w h i l e 
i n 


T h e B A S I C i n t e r p r e t e r c o n t a i n s a n A s s e m b l e r w h i c h a c c e p t s s t a n d a r d 
6 5 0 2 
m n e m o n i c s . 


V a r i a b l e s : 


V a r i a b l e n a m e s m a y b e o f u n l i m i t e d l e n g t h a n d a l l 
c h a r a c t e r s 
a r e 
s i g n i ﬁ c a n t . 
V a r i a b l e 
n a m e s 
m u s t 
s t a r t 


w i t h 
a l e t t e r . 


A . . Z , 
a . . z , 
0 . . 9 
a n d 
u n d e r l i n e , 


a l l o w e d . 
U p p e r 
a n d 


n a m e 
a r e 
d i f f e r e n t . 


T h e y c a n o n l y c o n t a i n t h e c h a r a c t e r s 


E m b e d d e d k e y w o r d s a r e 


l o w e r 
c a s e 
v a r i a b l e s 
o f 
t h e 
s a m e 


K e y w o r d s a r e 
b o t h 
in ADEGASN). 
T I M E 
e t c . ) 


( p s e u d o - ) 
A i s a v a r i a b l e , t h e n A B c a n b e ) . 
e t c . 
a r e 
n o t 
a l l o w e d . 


r e c o g n i s e d b e f o r e a n y t h i n g e l s e ( e . g . 


D E G a n d A S N i n D E G A S N a r e r e c o g n i s e d , b u t n e i t h e r 


Pseudo variables (PI, LOMEM, HIMEM, PAGE, 


a c t 
a s 
v a r i a b l e s 
i n 
t h a t 
i f 
P I 
i s 
a 


v a r i a b l e t h e n i t d o e s n o t a f f e c t P I L E ( o r i f 


N o t e 
t h a t 
P I % , 
P I $ 


T h e f o l l o w i n g t y p e s o f v a r i a b l e a r e a l l o w e d ; 


r e a l 
n u m e r i c 


i n t e g e r n u m e r i c 
s t r i n g 


A 


A % 
A $ 


T h e v a r i a b l e s @ % . . Z % a r e r e g a r d e d a s s p e c i a l i n t h a t 
they are not cleared by the commands or statements RUN, 
CHAIN and CLEAR. In addition A%, C%, X% 
s p e c i a l 
u s e s 
i n 
C A L L 
a n d 


s p e c i a l m e a n i n g i n t h e a s s e m b l e r 
c o u n t e r ) . 
T h e 
s p e c i a l 
v a r i a b l e 
@ % 


p r i n t f o r m a t t i n g . 
T h e v a r i a b l e s @ % . . Z % a r e c a l l e d " s t a t i c v a r i a b l e s " , a l l 
o t h e r v a r i a b l e s a r e c a l l e d " d y n a m i c v a r i a b l e s " . 


Real variables have arange of approximately +-1E-38 to 
+ - 1 E 3 8 a n d n u m e r i c f u n c t i o n s e v a l u a t e t o 9 s i g n i ﬁ c a n t 
ﬁ g u r e a c c u r a c y . I n t e r n a l l y e v e r y r e a l n u m b e r i s 
s t o r e d 
i n 
4 0 
b i t s . 


a n d 
Y % 
h a v e 


U S R r o u t i n e s a n d P % h a s a 


( i t i s t h e p r o g r a m 


c o n t r o l s 
n u m e r i c 


I n t e g e r 
v a r i a b l e s 
a r e 
s t o r e d 
i n 
3 2 
b i t s 


r a n g e 
o f 
a b o u t 
+ - 2 E 9 . 


a n d 
h a v e 
a 


S t r i n g v a r i a b l e s m a y c o n t a i n u p t o 2 5 5 c h a r a c t e r s . 


A l l a r r a y s m u s t b e d i m e n s i o n e d b e f o r e u s e . 
All statements can also be used as direct commands. 
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f u n c t i o n 
X = A B S ( d e ﬁ c i t ) 
l e n g t h = A B S ( X 1 - X 2 ) 
B = A B S A 


g i v i n g t h e a b s o l u t e v a l u e o f i t s a r g u m e n t . 
A B S 
A 


A f u n c t i o n 
g i v i n g 
t h e 
a r c 
c o s i n e 
o f 
i t s 
a r g u m e n t 
i n 


r a d i a n s . 


X = A C S ( Y ) 


A C S 


A f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
l a s t 
k n o w n 
v a l u e 
o f 
A D C 


c h a n n e l 
n . 


X = A D VA L ( i n t e n s i t y ) 
Y = A D V A L N 


Z = A D V A L 2 


A D V A L 


T h e o p e r a t i o n o f i n t e g e r b i t w i s e l o g i c a l A N D b e t w e e n 
t w o 
i t e m s . 


I F 
A = 2 
A N D 
B = 3 
T H E N 
1 1 0 


A = X 
A N D 
3 


A N D 


A f u n c t i o n 
r e t u r n i n g 
t h e A S C I I 
c h a r a c t e r 
v a l u e 
o f 
t h e 


ﬁ r s t c h a r a c t e r o f t h e a r g u m e n t s t r i n g . I f t h e s t r i n g 
i s 
n u l l 
t h e n 
- 1 
w i l l 
b e 
r e t u r n e d . 


X=ASC(A$) 
X=ASC("HELLO") 
X = A S C " e " 
X = A S C ( M I D $ ( A $ , Z ) ) 


A S C 


A f u n c t i o n 
g i v i n g 
t h e 
a r c 
s i n e 
o f 
i t s 
a r g u m e n t 
i n 


r a d i a n s . 


X = A S N ( Y ) 


A S N 


A f u n c t i o n 
g i v i n g 
t h e 
a r c 
t a n g e n t 
o f 
i t s 
a r g u m e n t 
i n 


r a d i a n s . 


X = AT N ( Y ) 


A T N 


A c o m m a n d 
a l l o w i n g 
t h e 
u s e r 
t o 
e n t e r 
l i n e s 
w i t h o u t 


ﬁ r s t t y p i n g i n t h e n u m b e r o f t h e l i n e , 
l e f t w i t h < e s c a p e > . S t e p s i z e r a n g e i s 1 t o 2 5 5 . 


o f f e r s l i n e n u m b e r s 1 0 , 2 0 , 3 0 
s t a r t s a t 1 0 0 w i t h s t e p 1 0 
s t a r t s a t 1 0 0 w i t h s t e p 1 
s t a r t s a t 1 0 w i t h s t e p 2 


A U T O 


A U T O 
m o d e 
i s 


A U T O 
● 
● 
● 
● 


A U T O 
1 0 0 


A U T O 1 0 0 , 1 
A U T O , 2 
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A f u n c t i o n 
w h i c h 
g e t s 
a b y t e 
f r o m 
t h e 
ﬁ l e 
w h o s e 


c h a n n e l n u m b e r i s i t s a r g u m e n t . 


E = B G E T # N 


B G E T # 


B P U T # 
A s t a t e m e n t w h i c h p u t s a b y t e t o t h e ﬁ l e w h o s e c h a n n e l 
n u m b e r i s t h e ﬁ r s t a r g u m e n t , 
l e a s t 
s i g n i ﬁ c a n t 
b y t e 
i s 
s e n t . 


B P U T # E , 3 2 
B P U T # S TA F F F I L E , A / 2 5 6 


T h e s e c o n d a r g u m e n t ' s 


C A L L 
A s t a t e m e n t 
t o 
c a l l 
a p i e c e 
o f 
m a c h i n e 
c o d e . 
C A L L 


i n i t i a l i s e s 
a v e c t o r 
a t 
a d d r e s s 
h e x 
0 6 0 0 
i n 
s t o r e 


( a c t u a l l y i f ' s t h e s t r i n g i n p u t b u f f e r ) t o c o n t a i n t h e 
n u m b e r o f p a r a m e t e r s a n d p o i n t e r s t o e a c h p a r a m e t e r 
w i t h a n a t t a c h e d t y p e . T h e p r o c e s s o r ' ' s A , X , a n d Y 
r e g i s t e r s 
a n d 
t h e 
C c a r r y 
ﬂ a g 
a r e 
i n i t i a l i s e d 
t o 
t h e 


l e a s t s i g n i ﬁ c a n t b y t e s o f A % , X % a n d Y % a n d t h e l e a s t 
s i g n i ﬁ c a n t 
b i t 
o f 
C % 
r e s p e c t i v e l y , 
s e e 
a l s o 
U S R . 


P a r a m e t e r 
t y p e s 
a r e : 


0 : b y t e ( 8 b i t s ) e . g . ? A % 
4 : w o r d ( 3 2 b i t s ) e . g . ! A % o r A % 
5 : 
r e a l 
( 4 0 
b i t s ) 
e . g . 
A 


1 2 8 : ﬁ x e d s t r i n g e . g . $ A % t e r m i n a t e d b y C H R $ 1 3 
1 2 9 : m o v a b l e s t r i n g e . g . A $ 


O n e n t r y t o t h e s u b r o u t i n e t h e p a r a m e t e r b l o c k c o n t a i n s 
t h e f o l l o w i n g v a l u e s : 


N u m b e r o f p a r a m e t e r s - 1 b y t e 
Parameter address 
- 
2 
bytes 


Parameter type 
- 
1 
b 
y 
t 
e 


Parameter address 
) 
repeated 
as 
o f t e n 


Parameter type 
) 
a s 
n e c e s s a r y 


T h e 
v a l u e 
g i v e n 
i s 
t h e 
a b s o l u t e 
a d d r e s s 
o f 
t h e 
i t e m 


e x c e p t 
f o r 
t y p e 
1 2 9 
w h e r e 
i t 
i s 
t h e 
a d d r e s s 
o f 
a 


p a r a m e t e r 
b l o c k 
c o n t a i n i n g 
s t a r t 
a d d r e s s , 
m a x i m u m 


l e n g t h a n d c u r r e n t l e n g t h . 


C A L L M U L D I V , A , B , C , D 
C A L L 
& F F E 3 


C A L L 1 2 3 4 0 , A $ , M , J $ 


C H A I N 
A s t a t e m e n t w h i c h w i l l l o a d a n d r u n t h e p r o g r a m w h o s e 
n a m e 
i s 
s p e c i ﬁ e d 
i n 
t h e 
a r g u m e n t . 
A l l 
v a r i a b l e s 


e x c e p t @ % t o Z % a r e C L E A R e d . 


C H A I N 
" G A M E l " 


C H A I N A $ 
C H A I N ( " j i m " ) 
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% 


CHR$ 
A s t r i n g f u n c t i o n w h o s e v a l u e i s a s t r i n g o f l e n g t h 1 
c o n t a i n i n g t h e A S C I I c h a r a c t e r s p e c i ﬁ e d b y t h e l e a s t 
signiﬁcant byte of the numeric argument. 


A$=CHR$(72) 
B $ = C H R $ 1 2 
C$=CHR$(A/200) 


C L E A R 
A s t a t e m e n t w h i c h c l e a r s a l l t h e d y n a m i c a l l y d e c l a r e d 
v a r i a b l e s , i n c l u d i n g s t r i n g s . T h e v a r i a b l e s @ % t o Z % 
a r e s t a t i c : C L E A R w i l l n o t a l t e r t h e s e a t a l l . 


C L O S E 
A s t a t e m e n t u s e d t o c l o s e a s e q u e n t i a l ﬁ l e , 
w i l l c l o s e a l l s e q u e n t i a l ﬁ l e s . 


C L O S E # E 
C L O S E # 0 


C L O S E # 0 


C L G 
A s t a t e m e n t w h i c h i s e q u i v a l e n t t o P R I N T C H R $ 1 6 ; . 


o n 
t h e 
v d u 
t o 
t h e 
c u r r e n t 


background colour and moves the graphics 


I 
t 


c l e a r s t h e g r a p h i c s a r e a 
g r a p h i c s 
p o i n t e r t o 0 , 0 ( b o t t o m l e f t ) . 


C L S 
A s t a t e m e n t w h i c h i s e q u i v a l e n t t o P R I N T C H R $ 1 2 ; . 
c l e a r s t h e t e x t a r e a o n t h e v d u t o t h e c u r r e n t t e x t 
b a c k g r o u n d c o l o u r a n d m o v e s t h e c u r s o r t o 0 , 0 ( t o o 
l e f t ) . 


I 
t 


C O L O U R 
A s t a t e m e n t 
w h i c h 
s e t s 
t h e 


b a c k g r o u n d c o l o u r s o f t h e 
I f 
t h e 


a f f e c t e d , 
a f f e c t e d . 
T h e 
c o l o u r s 
a r 


0 
1 
2 
8 


1 
1 2 9 


2 
1 3 0 


3 
1 3 1 


t e x t 
f o r e g r o u n d 
a n d 


s o f t " d i s p l a y s ( m o d e s 0 - 6 ) . 


a r g u m e n t i s > 1 2 7 t h e t e x t b a c k g r o u n d c o l o u r i s 


o t h e r w i s e t h e t e x t f o r e g r o u n d 


I I 


c o l o u r 
i s 


e a s f o l l o w s w i t h t h e d e f a u l t p a l e t t e : 


b l a c k 


r e d 


g r e e n 
y e l l o w 
b l u e 


m a g e n t a 


c y a n 
w h i t e 
ﬂ a s h i n g 
b l a c k - w h i t e 


ﬂ a s h i n g r e d - c y a n 
ﬂ a s h i n g g r e e n - m a g e n t a 
ﬂ a s h i n g y e l l o w - b l u e 
ﬂ a s h i n g 
b l u e - y e l l o w 


ﬂ a s h i n g m a g e n t a - g r e e n 
ﬂ a s h i n g c y a n - r e d 
ﬂ a s h i n g w h i t e - b l a c k 


4 
1 3 2 


5 
1 3 3 


6 
1 3 4 


7 
1 3 5 


8 
1 3 6 


9 
1 3 7 


1 0 
1 3 8 


1 1 
1 3 9 


1 2 
1 4 0 


1 3 
1 4 1 


1 4 
1 4 2 


1 5 
1 4 3 
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C O L O U R 
3 


C O L O U R N + 1 2 8 


C O S 
A f u n c t i o n g i v i n g t h e c o s i n e o f i t s r a d i a n a r g u m e n t . 


X = C O S ( Y ) 


C O U N T 
A f u n c t i o n r e t u r n i n g t h e n u m b e r o f c h a r a c t e r s p r i n t e d 
s i n c e t h e l a s t n e w l i n e ( t h i s i s n o t n e c e s s a r i l y t h e 
s a m e a s P O S ) . 


A = C O U N T 


o b j e c t w h i c h m u s t p r e c e d e a l l l i s t s o f d a t a 


o r 
u n q u o t e d 


v a l u e s m a y i n c l u d e 


D A T A 
A p r o g r a m 
f o r 
R E A D , 


a s 
f o r 


The string values may be quoted 
I N P U T, 
n u m e r i c 


c a l c u l a t i o n s o l o n g a s t h e r e a r e n o r e s e r v e d w o r d s . 


D ATA 1 0 , 2 , H E L L O , " T H I S I S A C O M M A , " 
D A T A 0 , l , 2 , 3 . 4 , j i m , 


t h e 


ﬂ 
p r i n t " , P R I N T 


D E G 
A f u n c t i o n w h i c h c o n v e r t s r a d i a n s t o d e g r e e s . 


X = D E G { P I / 2 ) 
X = D E G ( A S N ( 1 ) ) 


D E F 
A p r o g r a m o b j e c t w h i c h m u s t p r e c e d e d e c l a r a t i o n o f a 
u s e r 
f u n c t i o n 
F N 
o r 
a u s e r 
p r o c e d u r e 
P R O C . 
I f 


e n c o u n t e r e d 
a t 
e x e c u t i o n 
t h e n 
t h e 
r e s t 
o f 
t h e 


i g n o r e d 
s o 
t h a t 
s i n g l e 
l i n e 


a n y w h e r e i n t h e p r o g r a m . M u l t i 
n o t b e e x e c u t e d ; i t i s r e c o m m e n d e d t h a t t h e y a r e p l a c e d 
at the end of the main program text. There is no speed 
a d v a n t a g e g a i n e d i n p l a c i n g t h e m a t t h e s t a r t o f t h e 
p r o g r a m . 


D E F 
F N M E A N 


D E F 
P R O C J I M 
. . . 


l i n e 
i s 


d e ﬁ n i t i o n s c a n b e p u t 
l i n e 
d e ﬁ n i t i o n s 
m u s t 


● 
● 
● 
● 


D E L E T E 
A c o m m a n d w h i c h d e l e t e s a g r o u p o f l i n e s f r o m t h e 
p r o g r a m . B o t h s t a r t a n d e n d l i n e s o f t h e g r o u p w i l l b e 
d e l e t e d . 


D E L E T E 1 0 , 1 5 
D E L E T E 0 , 2 0 
D E L E T E 2 0 , 3 2 7 6 7 d e l e t e a l l l i n e s a f t e r 1 9 


d e l e t e 1 0 , 11 , 1 2 , 1 3 , 1 4 , 1 5 
d e l e t e u p t o 2 0 
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A s t a t e m e n t 
w h i c h 
d e c l a r e s 
a r r a y s , 


p r e d e c l a r e d 
b e f o r e 
u s e . 


d i m e n s i o n a l . 
A f t e r 
D I M 
a l l 
e l e m e n t s 


0 / n u l l . 
b e u s e d t o d i m e n s i o n i n t e g e r s t o p o i n t 


D I M 
A r r a y s 
m u s t 
b e 


S t r i n g a r r a y s m a y b e m u l t i 


i n 
t h e 
a r r a y 
a r e 


A r r a y s m a y n o t b e r e d i m e n s i o n e d . D I M c a n a l s o 


a t 
a n 
a r e a 
o f 


m e m o r y 
w h i c h 
t h e 
i n t e r p r e t e r 
w i l l 
n o t 
t h e n 
u s e . T h i s 


c a n b e u s e d f o r p o s i t i o n e d s t r i n g s , d a t a s t r u c t u r e s a n d 
a s s e m b l e r e t c . T h e l a s t i t e m i n t h e e x a m p l e s e t s A % t o 
a n a r e a o f m e m o r y w i t h b y t e s A % ? 0 t o A % ? 6 7 f r e e f o r u s e 
b y t h e p r o g r a m . T h e s u b s c r i p t b a s e i s 0 s o D I M X ( 1 2 ) 
d e ﬁ n e s a n a r r a y o f 1 3 e l e m e n t s . 


D I M A ( 2 ) , A b ( 2 , 3 ) , A $ ( 2 , 3 , 4 ) , A % ( 3 , 4 , 5 , 6 ) , A % 6 7 


A b i n a r y o p e r a t i o n g i v i n g t h e i n t e g e r q u o t i e n t o f t w o 
i t e m s . 


D I V 


X = A 
D I V 
B 


D r a w 
a l i n e 
t o 
t h e 
s p e c i ﬁ e d 
p o s i t i o n 
i n 
t h e 
c u r r e n t 


g r a p h i c s f o r e g r o u n d c o l o u r . T h i s s t a t e m e n t i s e x a c t l y 
e q u i v a l e n t t o P L O T S . 


DRAW X,Y 


D R A W 


A s t a t e m e n t 
d e l i m i t e r 
w h i c h 
b e h a v e s 
a s 
f o l l o w s ; 


W h e n 
e n c o u n t e r e d 
a s 
a d e l i m i t e r 
t h e 
r e s t 
o f 
t h e 
l i n e 
i s 


i g n o r e d . 
I f 
i n 
a n 
I F 
s t a t e m e n t 
t h e 
b o o l e a n 
i s 
f a l s e 


t h e 
s t a t e m e n t s 
a f t e r 
E L S E 
w i l l 
b e 
e x e c u t e d . 
T h i s 
m a k e s 


t h e f o l l o w i n g w o r k : 


I F 
A = B 
T H E N 
B = C 
E L S E 
B = D 


I F A = B T H E N B = C : P R I N T " W W W W " E L S E B = D ; P R I N T " Q Q Q Q 
IF A=B THEN B=C ELSE IF A=C THEN 


B u t 
t h i s 
d o e s 
n o t 
w o r k : 


I F A = B T H E N B = C ; I F C = D T H E N B = Q E L S E B = P E L S E B = W 


E L S E a l s o t r a p s e x c e p t i o n s i n O N . 


E L S E 


I I 


A s t a t e m e n t c a u s i n g t h e i n t e r p r e t e r t o r e t u r n t o d i r e c t 
m o d e , 
a n y w h e r e i n a p r o g r a m . 


E N D 


T h e r e c a n b e a n y n u m b e r ( > = 0 ) o f E N D s t a t e m e n t s 


A s t a t e m e n t d e n o t i n g t h e e n d o f a p r o c e d u r e . A l l L O C A L 
v a r i a b l e s 
a n d 
t h e 
d u m m y 
a r g u m e n t s 
a r e 
r e s t o r e d 
a t 


E N D P R O C a n d t h e p r o g r a m r e t u r n s t o t h e s t a t e m e n t a f t e r 
t h e c a l l i n g s t a t e m e n t . 


E N D P R O C 


A s t a t e m e n t t a k i n g 1 4 p a r a m e t e r s w h i c h a r e b y t e s , 
b y t e s a r e p a s s e d t o t h e M a c h i n e O p e r a t i n g S y s t e m t o 
c o n t r o l t h e s o u n d g e n e r a t o r . 


E N V E L O P E 
0 , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 1 0 , 1 1 , 1 2 , 1 3 


E N V E L O P E 
T h e 


( C ) C o p y r i g h t B B C S e p t e m b e r 1 9 8 2 P a g e 1 0 


/ 


( T R U E ) 
i f 
t h e 
ﬁ l e 
A f u n c t i o n 
w h i c h 
w i l l 
r e t u r n 


whose channel number is the argument is at its end. 


IF EOF#B THEN 


- 
1 
E O F # 


T h e o p e r a t i o n o f b i t w i s e i n t e g e r l o g i c a l e x c l u s i v e - o r 
b e t w e e n t w o i t e m s a s 3 2 b i t i n t e g e r s . 


I F 
A = 2 
E O R 
B = 3 
T H E N 
1 1 0 


B E O R 
4 


E O R 


X 


A f u n c t i o n r e t u r n i n g t h e l i n e n u m b e r o f t h e l i n e w h e r e 
t h e 
l a s t 
e r r o r 
o c c u r r e d . 


X = E R L 


E R L 


A f u n c t i o n r e t u r n i n g t h e e r r o r c o d e n u m b e r o f t h e l a s t 
e r r o r 
w h i c h 
o c c u r r e d . 


X = E R R 


E R R 


A f u n c t i o n w h i c h a p p l i e s t h e i n t e r p r e t e r ' s e x p r e s s i o n 
e v a l u a t i o n p r o g r a m t o t h e c h a r a c t e r s h e l d i n t h e 
a r g u m e n t s t r i n g . A n e a s y w a y t o p a s s a f u n c t i o n i n t o a 
p r o g r a m f r o m a u s e r i n p u t . 


X = E V A L ” 3 
X=EVAL("X^Q+Y''P") 
X = E VA L " A $ + B $ 
X$=EVAL(A$) 


E V A L 


I I 


I I 


A f u n c t i o n r e t u r n i n g e t o t h e p o w e r o f t h e a r g u m e n t . 


Y = E X P ( Z ) 


E X P 


A f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
l e n g t h , 
i n 
b y t e s , 
o f 
t h e 


ﬁ l e w h o s e c h a n n e l n u m b e r i s t h e a r g u m e n t . T h i s d o e s 
n o t 
w o r k 
w i t h 
c a s s e t t e 
ﬁ l e s . 


L = E X T # E 


E X T # 


A f u n c t i o n 
r e t u r n i n g 
0 , 
i . e . 
f a l s e . 
F A L S E 
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f 


F N 
A r e s e r v e d 
w o r d 
u s e d 
a t 
t h e 
s t a r t 
o f 
a l l 
u s e r 
d e c l a r e d 


f u n c t i o n s . A f u n c t i o n m a y b e d e ﬁ n e d w i t h a n y n u m b e r 
o f a r g u m e n t s o f a n y t y p e , a n d m a y r e t u r n ( u s i n g = ) a 
s t r i n g o r n u m e r i c q u a n t i t y . A f u n c t i o n d e ﬁ n i t i o n i s 
terminated by 
u s e d 
i n 
t h e 
s t a t e m e n t 
p o s i t i o n . 
T h e 


a r g u m e n t s a r e p a s s e d b y v a l u e . 


DBF FNMEAN(Q1,Q2,Q3,Q4)=(Q1+Q2+Q3+Q4)/4 
D B F 
F N F A C T O R I A L ( N ) 
I F 
N < 2 
T H E N 
= 1 
E L S E 


= F N F A C T 0 R I A L ( N - 1 ) * N 


DEF FNRIGHT2(A$)=RIGHT$(A$,2) 
DEF FNREVERSE(A$) L0CALB$,Z% 
F O R Z % = 1 T 0 L E N ( A $ ) : B $ = M I D $ ( A $ , Z % , 1 ) + B $ : N E X T: = B $ 


F O R 
A s t a t e m e n t i n i t i a l i s i n g a F O R N E X T l o o p . T h e l o o p i s 
e x e c u t e d a t l e a s t o n c e . G O T O i n s i d e a l o o p i s i n 
e x t e n d e d r a n g e ( w h i c h m e a n s y o u c a n ^ t e x i t t h e l o o p 
w i t h G O T O w i t h o u t l e a v i n g i t s t i l l o p e r a t i v e ) . A n y 
n u m e r i c a s s i g n a b l e i t e m m a y b e u s e d a s t h e c o n t r o l 
v a r i a b l e . I n t e g e r c o n t r o l v a r i a b l e s a r e t h r e e t i m e s 
q u i c k e r t h a n r e a l v a r i a b l e s a t t h e N E X T s t a t e m e n t a n d 
a r e a l s o m u c h f a s t e r w h e n i n d e x i n g a n a r r a y. 


F O R T E M P E R A T U R E % = 0 T O 9 
F O R A ( 2 , 3 , l ) = 0 T O 9 
F O R 
X = 1 
T O 
1 6 
S T E P 
0 . 3 : 
P R I N T 
X : 
N E X T 
X 


G C O L 
A s t a t e m e n t 
t o 
s e t 
t h e 
g r a p h i c s 
f o r e g r o u n d 
a n d 


b a c k g r o u n d c o l o u r s a n d a c t i o n s . T h e ﬁ r s t v a l u e i s t h e 
a c t i o n ( 0 = s t o r e , 1 = O R , 2 = A N D , 3 = E O R , 4 = i n v e r t ) 
a n d t h e s e c o n d i s t h e c o l o u r, i f > 1 2 7 t h e n b a c k g r o u n d , 
e l s e f o r e g r o u n d ( s e e C O L O U R ) . 


G C O L 0 , R E D 
G C O L 2 , 1 2 9 


GET,GET$ 
A f u n c t i o n a n d c o m p a t i b l e s t r i n g f u n c t i o n t h a t r e a d s 
t h e n e x t c h a r a c t e r f r o m t h e i n p u t s t r e a m , u s u a l l y t h e 
k e y b o a r d ( i t w a i t s f o r t h e c h a r a c t e r ) . S e e I N K E Y . 


N = G E T 
N$=GET$ 


G O T O 
A s t a t e m e n t 
w h i c h 
w i l l 
g o 
t o 
a l i n e 
w i t h 
c o n s t a n t 


n u m b e r 
o r 
c a l c u l a t e d 
v a l u e . 
I f 
a c a l c u l a t e d 
v a l u e 
i s 


u s e d , t h e p r o g r a m s h o u l d n o t b e R E N U M B E R e d . 


G O T O 
1 0 0 


G O T O ( X * 1 0 ) 
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A s G O T O b u t a l l o w s R E T U R N . M a x i m u m d e p t h i s 2 6 n e s t e d 
G O S U B s . 


G O S U B 
4 0 0 


G O S U B ( 4 * A N S W E R + 6 ) 


G O S U B 


A p s e u d o - v a r i a b l e 
w h i c h 
s e t s 
a n d 
g i v e s 
t h e 
m a x i m u m 


a d d r e s s u s e d b y t h e i n t e r p r e t e r . T h e u s e r i s c a u t i o n e d 
t o u s e t h i s f a c i l i t y w i t h c a r e ! 


H I M E M = H I M E M - 4 0 


H I M E M 


I 
F 
A s t a t e m e n t . 


I F l e n g t h = 5 T H E N 11 0 
I F A < C 
O R A > D 
G O T O 
1 1 0 


I F A > C A N D 
C > = D 
T H E N 
G O T O 
1 1 0 
E L S E 
P R I N T 
S T R U C T U R E D 


B A S I C 


I F A < Q P R I N T " ! T H I N K I T I S L E S S 
I F A > Q T H E N P R I N T " ! T H I N K I T I S G R E A T E R 
I F A > = Q T H E N P R I N T " G R E AT E R O R E Q U A L " : E N D 


I f 


I I 


A f u n c t i o n 
a n d 
c o m p a t i b l e 
s t r i n g 
f u n c t i o n 
t h a t 
w i l l 
d o 


f o r 
a m a x i m u m 
o f 
n c l o c k 
t i c k s 


I f n o k e y i s p r e s s e d i n t h e t i m e 


r e t u r n 
- 1 
a n d 
I N K E Y $ 
w i l l 
r e t u r n 
a 


I N K E Y 


a G E T / G E T $ , 
w a i t i n g 


( u s u a l l y 1 0 m s e a c h ) . 
l i m i t 
I N K E Y 
w i l l 


n u l l 
s t r i n g . 


I f I N K E Y h a s a n e g a t i v e a r g u m e n t t h e n T R U E o r F A L S E i s 
r e t u r n e d d e p e n d i n g o n w h e t h e r t h e k e y s p e c i ﬁ e d b y t h e 
a r g u m e n t i s d e p r e s s e d a t t h a t i n s t a n t . 


N = I N K E Y ( 0 ) 
N$=I NKEY$(100) 
I F I N K E Y ( - 9 9 ) T H E N P R I N T " S p a c e b a r i s p r e s s e d " 


I N P U T 
A s t a t e m e n t t o i n p u t v a l u e s f r o m t h e c u r r e n t i n p u t 
s t r e a m ( u s u a l l y k e y b o a r d ) . 


INPUT A,B,C,D$,"WHO ARE YOU",W$,"NAME"R$ 


I f i t e m s a r e n o t i m m e d i a t e l y p r e c e d e d b y a p r i n t a b l e 
s t r i n g ( e v e n i f n u l l ) t h e n a " ? " w i l l b e p r i n t e d a s a 
prompt. Items A, B, C, D$ in the above example can have 
their answers returned on one to four lines, separate 
i t e m s b e i n g s e p a r a t e d b y c o m m a s . E x t r a i t e m s w i l l b e 
i g n o r e d . T h e n W H O A R E Y O U ? 
mark comes from the comma) and W$ is input, 
i s p r i n t e d a n d R $ i s i n p u t , 
e x a c t l y e q u i v a l e n t t o I N P U T A $ : A 
s p a c e s 
w i l l 
b e 
r e m o v e d 


s p a c e s . S t r i n g s i n " e d f o r m a r e t a k e n a s t h e y a r e , w i t h 
a p o s s i b l e e r r o r o c c u r r i n g f o r a m i s s i n g c l o s i n g q u o t e . 


i s p r i n t e d ( t h e q u e s t i o n 


t h e n 
N A M E 


T h e 
s t a t e m e n t 
I N P U T 
A i s 


VA L ( A $ ) . L e a d i n g 


f r o m i n p u t , b u t n o t t r a i l i n g 
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I N P U T L I N E A s t a t e m e n t o f i d e n t i c a l s y n t a x t o I N P U T w h i c h u s e s a 


n e w l i n e f o r e a c h i t e m t o b e i n p u t . T h e i t e m i n p u t i s 
t a k e n 
a s 
i s , 
i n c l u d i n g 
c o m m a s , 
q u o t e s 
a n d 
l e a d i n g 


s p a c e s . 


I N P U T L I N E A $ 


A s t a t e m e n t 
w h i c h 
r e a d s 
d a t a 
i n 
i n t e r n a l 
f o r m a t 
f r o m 
a 


ﬁ l e a n d p u t s t h e m i n t h e s p e c i ﬁ e d v a r i a b l e s . 


I N P U T # E , A , B , C , D $ , E $ , F $ 


I N P U T # 


A f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
p o s i t i o n 
o f 
a s u b - s t r i n g 


w i t h i n a s t r i n g , o p t i o n a l l y s t a r t i n g t h e s e a r c h a t a 
s p e c i ﬁ e d p l a c e i n t h e s t r i n g , 
n o t 
f o u n d 
0 i s 
r e t u r n e d . 


X = I N S T R ( A $ , B $ ) 
Y=INSTR(A$,B$,Z%) 
;REM START SEARCH AT POSITION Z% 


I N S T R 


I f 
t h e 
s u b - s t r i n g 
i s 


A f u n c t i o n 
t r u n c a t i n g 
a r e a l 
n u m b e r 
t o 
t h e 
l o w e r 


i n t e g e r i . e I N T ( 9 9 . 8 ) = 9 9 , I N T ( - 1 2 ) = - 1 2 , I N T ( - 1 2 . 1 ) = - 1 3 . 


X = I N T ( Y ) 


I N T 


A s t r i n g 
f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
l e f t 
n c h a r a c t e r s 


o f t h e s t r i n g . I f t h e r e a r e i n s u f ﬁ c i e n t c h a r a c t e r s i n 
t h e s t r i n g t h e n a l l a r e r e t u r n e d . 


A $ = L E F T $ ( A $ , 2 ) 
A $ = L E F T $ ( R I G H T $ ( A $ , 3 ) , 2 ) 


L E F T $ 


A f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
l e n g t h 
o f 
t h e 
a r g u m e n t 


s t r i n g . 


X=LEN(A$) 
X = L E N " f r e d " 
X = L E N A $ 
X=LEN(A$+B$) 


L E N 


o p t i o n a l a s s i g n m e n t s t a t e m e n t . 
L E T 


A c o m m a n d w h i c h c a u s e s l i n e s o f t h e c u r r e n t p r o g r a m t o 
b e 
l i s t e d 
o u t 
w i t h 
t h e 
a u t o m a t i c 
f o r m a t t i n g 
o p t i o n s 


s p e c i ﬁ e d b y L I S T O . 


L I S T 


L I S T 
, 1 1 1 


L I S T 
1 1 1 , 


L I S T 
1 1 1 , 2 2 2 


L I S T 
1 0 0 


N o t e 
t h a t 
L . 


L I S T 


l i s t s t h e e n t i r e p r o g r a m 
l i s t s 
u p 
t o 
l i n e 
1 1 1 


l i s t s 
f r o m 
l i n e 
1 1 1 
t o 
t h e 
e n d 


l i s t s 
l i n e s 
1 1 1 
t o 
2 2 2 
i n c l u s i v e 


l i s t s 
l i n e 
1 0 0 
o n l y 


i s 
a c o n v e n i e n t 
a b b r e v i a t i o n 
f o r 
L I S T . 
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L I S T O 
A c o m m a n d 
w h i c h 
s e t s 
o p t i o n s 
f o r 
f o r m a t t i n g 
a L I S T e d 


p r o g r a m . 
L I S T O 
t a k e s 
a n 
i n t e g e r 
0 t o 
7 , 
t h e 
b i t s 
o f 


w h i c h c o n t r o l s t r i n g s a , b a n d c : 
S t r i n g 
a i s 
p r i n t e d 
o u t 
j u s t 
a f t e r 
e v e r y 
l i n e 
n u m b e r . 


S t r i n g 
b i s 
p r i n t e d 
o u t 
n t i m e s 
j u s t 
a f t e r 
a w h e r e 
n i s 


t h e l e v e l o f n e s t e d F O R N E X T l o o p s . 
S t r i n g 
c i s 
p r i n t e d 
o u t 
m t i m e s 
j u s t 
a f t e r 
b w h e r e 
m i s 


t h e l e v e l o f n e s t e d R E P E AT U N T I L l o o p s . 
T h e 
s t r i n g s 
a r e 


s p a c e ) , 
N o t e 
t h a t 
n a n d 
m a r e 
s e t 
a c c o r d i n g 
t o 
t h e 
l i n e s 


a c t u a l l y 
l i s t e d 
o u t 
s o 
f a r . 
I t 
i s 
u s e f u l 
t o 
s e t 
L I S T O 


0 w h e n 
d o i n g 
a l o t 
o f 
c u r s o r 
e d i t i n g , 
t h i s 
i s 
t h e 


d e f a u l t 
v a l u e . 


L I S T O 
7 


( s i n g l e 
s p a c e ) , 


I I 
I I 
( d o u b l e 


( d o u b l e s p a c e ) . 


f u n c t i o n 


a r g u m e n t . 


X = L N ( Y ) 


L N 
g i v i n g 
t h e 
n a t u r a l 
l o g a r i t h m 
o f 
i t s 
A 


L O A D 
A c o m m a n d 
w h i c h 
l o a d s 
a n e w 
p r o g r a m 
f r o m 
a ﬁ l e 
a n d 


CLEARS the variables of the old program. 


L O A D " P R O G l 
LOAD A$ 


I I 


L O C A L 
A s t a t e m e n t 
t o 
d e c l a r e 
v a r i a b l e s 
f o r 
l o c a l 
u s e 
i n s i d e 
a 


f u n c t i o n ( F N ) o r p r o c e d u r e ( P R O C ) . L O C A L s a v e s t h e 
v a l u e s o f i t s a r g u m e n t s i n s u c h a w a y t h a t t h e y w i l l b e 
r e s t o r e d a t = o r E N D P R O C . S e e F N f o r a n e x a m p l e . 


LOCAL A$,X,Y% 


L O G 
A f u n c t i o n 
g i v i n g 
t h e 
b a s e - 1 0 
l o g a r i t h m 
o f 
i t s 


a r g u m e n t . 


X = L O G ( Y ) 


L O M E M 
Apseudo-variable which controls where in memory the 
d y n a m i c d a t a s t r u c t u r e s a r e t o b e p l a c e d . T h e d e f a u l t 
i s 
T O P , 
t h e 
ﬁ r s t 
f r e e 
a d d r e s s 
a f t e r 
t h e 
e n d 
o f 
t h e 


p r o g r a m . C h a n g i n g L O M E M c a u s e s l o s s o f a l l d y n a m i c 
v a r i a b l e s . 


L O M E M = L O M E M + 1 0 0 


(C) Copyright BBC September 1982 Page 15 


M I D $ 
A s t r i n g 
f u n c t i o n 
w h i c h 
r e t u r n s 
N c h a r a c t e r s 
o f 
t h e 


s t r i n g s t a r t i n g f r o m c h a r a c t e r M . I f N i s n o t p r e s e n t 
o r i f t h e r e a r e i n s u f ﬁ c i e n t c h a r a c t e r s i n t h e s t r i n g 
t h e n 
a l l 
f r o m 
M o n w a r d s 
a r e 
r e t u r n e d . 


C $ = M I D $ ( A $ , M , N ) 
C $ = M I D $ ( A $ , Z ) 


M O D 
A b i n a r y o p e r a t i o n g i v i n g t h e s i g n e d r e m a i n d e r o f t h e 
i n t e g e r d i v i s i o n . M O D i s d e ﬁ n e d s u c h t h a t A M O D B = A 
- ( A D I V 
B ) * B 


X = A 
M O D 
B 


M O D E 
A s t a t e m e n t w h i c h w i l l s e l e c t t h e s p e c i ﬁ e d v d u s c r e e n 
m o d e 
( 0 - 7 ) . 


changing to aIK screen is automatically recovered by 
MODE. MODE cannot be used inside aPROC or FN, unless 
o n a s e c o n d p r o c e s s o r . 
T h e d i s p l a y m o d e s a r e a s f o l l o w s : 


0 
640x256 
2-colour 
graphics 
and 
80x32text 
( 
2 
0 
K 
) 


1 
320x256 
4-colour 
graphics 
and 
40x32text 
( 
2 
0 
K 
) 


2 
1 6 0 x 2 5 6 1 6 - c o l o u r g r a p h i c s a n d 2 0 x 3 2 t e x t ( 2 0 K ) 


3 
8 0 x 2 5 
2 - c o l o u r 
t e x t 


4 
320x256 
2-colour 
graphics 
and 
40x32t 
e 
x 
t 


5 
160x256 
4-colour 
graphics 
and 
20x32t 
e 
x 
t 


6 
4 0 x 2 5 
2 - c o l o u r 
t e x t 


7 
4 0 x 2 5 
t e l e t e x t 
m o d e 


M O D E 
0 


M O D E 
A 


T h e 
s p a c e 
p r o v i d e d 
b y 
a 
2 0 K 
s c r e e n 


( 1 6 K ) 
( l O K ) 
( l O K ) 
( 8 K ) 
( I K ) 


A s t a t e m e n t 
w h i c h 


s p e c i ﬁ e d 
p o s i t i o n . 


M O V E X , Y 


M O V E 
t h e g r a p h i c s p o i n t e r t o t h e 
m o v e s 
I t i s e x a c t l y e q u i v a l e n t t o P L O T 4 . 


A c o m m a n d w h i c h i n i t i a l i s e s t h e i n t e r p r e t e r f o r a n e w 
p r o g r a m 
t o 
b e 
t y p e d 
i n . 


r e c o v e r e d w i t h t h e O L D c o m m a n d p r o v i d e d n o v a r i a b l e s 
h a v e b e e n c r e a t e d a n d n o l i n e s h a v e b e e n t y p e d i n . 


N E W 


T h e o l d p r o g r a m m a y b e 


T h e s t a t e m e n t d e l i m i t i n g F O R N E X T l o o p s . N E X T t a k e s a n 
o p t i o n a l c o n t r o l v a r i a b l e ; i f p r e s e n t t h e n F O R N E X T 
l o o p s m a y b e ^ p o p p e d ' i n a n a t t e m p t t o m a t c h t o t h e 
c o r r e c t 
F O R 
s t a t e m e n t . 


N E X T 


N E X T J , K 


N E X T 
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T h i s 
i s 
a h i g h 
p r i o r i t y 
u n a r y 
o p e r a t o r 
( t h e 
s a m e 


p r i o r i t y a s u n a r y - ) . 


IF N0T(RATE>5 AND TIME<100) THEN 


N O T 


A c o m m a n d w h i c h u n d o e s t h e e f f e c t o f N E W p r o v i d e d n o 
n e w l i n e s h a v e b e e n t y p e d i n , a n d n o v a r i a b l e s h a v e 
b e e n 
c r e a t e d . 


O L D 


O N 
A s t a t e m e n t 
c o n t r o l l i n g 
a m u l t i - w a y 
s w i t c h 
o r 
e r r o r 


t r a p p i n g . 
T h e 
v a l u e s 
i n 
t h e 
l i s t 
a r e 
s k i p p e d 
w i t h o u t 


c a l c u l a t i o n 
b u t 
i t 
w i l l 
g e t 
c o n f u s e d 
b y 
A S C " , 


a p p e a r i n g . 


I I 


O N 
A + 2 G O T O 1 0 0 , 2 0 0 , 3 0 0 , 1 2 0 , 3 0 0 E L S E P R I N T " I l l e g a l 


O N B - 4 6 G O S U B 1 0 0 , 2 0 0 , ( 0 / 2 0 0 ) E L S E P R I N T " W h a t ? 
O N 
E R R O R 
P R I N T " S u i c i d e " ; E N D 


O N E R R O R G O T O 1 0 0 


O N 
E R R O R 
O F F : 


I I 


I I 


R E M 
s e t s 
b a c k 
n o r m a l 
e r r o r 
h a n d l e r 


A f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
c h a n n e l 
n u m b e r 
o f 
t h e 


ﬁ l e . T h e ﬁ l e i s o p e n e d f o r i n p u t a n d u p d a t i n g . I f i t 
d o e s 
n o t 
e x i s t 
0 i s 
r e t u r n e d . 
O P E N I N 
i s 
a n 
a b r e v i a t i o n 


of OPEN FOR INPUT. With the CFS input only is allowed, 
w i t h t h e D F S o r N F S i n p u t a n d o u t p u t a r e a l l o w e d 
( r a n d o m a c c e s s ) . 


X = O P E N I N " j i m 
X = O P E N I N A $ 
X=OPENIN(A$) 
X = 0 P E N I N ( " F I L E 1 " ) 


E x a m p l e o f r e a d i n g i n N ( 1 0 ) a n d N $ ( 1 0 ) , a t o p t e n 
a r r a y : 


A = O P E N I N " T O P T E N 


I F A = 0 
P R I N T " N o 
T O P T E N 
d a t a 
ﬁ l e " : E N D 


F O R Z = l TO 1 0 ; I N P U T # A , N ( Z ) , N $ ( Z ) : N E X T: C L O S E # A 


E x a m p l e o f w r i t i n g o u t t h e t o p t e n a r r a y : 


A = O P E N O U T " T O P T E N " 
F O R Z = l TO 1 0 : P R I N T # A , N ( Z ) , N $ ( Z ) : N E X T: C L O S E # A 


E x a m p l e o f r e a d i n g t h e b y t e s i n T O P T E N b a c k w a r d s : 


A = O P E N I N " T O P T E N 
FORZ=EXT#A-lTOOSTEP-1:PTR#A=Z:PRINTBGET#A;:NEXT:CLOSE#A 


O P E N I N 


I I 


I I 


I I 


O P E N O U T 
A f u n c t i o n 
w h i c h 
c r e a t e s 
a ﬁ l e 
a n d 
r e t u r n s 
i t s 
c h a n n e l 


n u m b e r . 
i s 
ﬁ r s t 
d e l e t e d . 


F O R O U T P U T . 


X=OPENOUT(A$) 
X=OPENOUT("DATAFILE") 


I 
f 
a ﬁ l e o f t h a t n a m e i s a l r e a d y p r e s e n t i t 


O P E N O U T 
i s 
a n 
a b b r e v i a t i o n 
o f 
O P E N 


(C) Copyright BBC September 1982 Page 17 


O P T 
A n a s s e m b l e r p s e u d o o p e r a t i o n c o n t r o l l i n g t h e m e t h o d o f 
a s s e m b l y, 
f o l l o w i n g m e a n i n g s 


A c t i o n 


a s s e m b l e r e r r o r s s u p p r e s s e d ; n o l i s t i n g 
a s s e m b l e r e r r o r s s u p p r e s s e d ; l i s t i n g 
a s s e m b l e r e r r o r s o c c u r ; n o l i s t i n g 
a s s e m b l e r e r r o r s o c c u r ; l i s t i n g 


W h e r e t h e p o s s i b l e a s s e m b l e r e r r o r s a r e b r a n c h o u t o f 
r a n g e a n d u n k n o w n l a b e l . T h e d e f a u l t O P T i s 3 . 


O P T i s f o l l o w e d b y a n e x p r e s s i o n w i t h t h e 


V a l u e 


0 


1 


2 


3 


O R 
T h e o p e r a t i o n o f b i t w i s e i n t e g e r l o g i c a l O R b e t w e e n t w o 
i t e m s : 


I F 
A = 2 
O R 
B = 3 
T H E N 
1 1 0 


X = B O R 4 


A p s e u d o - v a r i a b l e c o n t r o l l i n g t h e s t a r t i n g a d d r e s s o f 
t h e c u r r e n t t e x t a r e a . W i t h c a r e s e v e r a l p r o g r a m s c a n 
b e 
l e f t 
a r o u n d 
i n 
R A M 
m e m o r y 
w i t h o u t 
t h e 
n e e d 
f o r 


s a v i n g t h e m . P A G E i s a l w a y s a n i n t e g e r m u l t i p l e o f 
2 5 6 . 


P A G E 


P A G E = 2 5 * 2 5 6 
P A G E = P A G E + 5 1 2 


A f u n c t i o n r e t u r n i n g 3 . 1 4 1 5 9 2 6 5 . 


X = P I 


P I 


P L O T 
A s t a t e m e n t c o n t r o l l i n g m o s t o f t h e g r a p h i c s . T h e 
ﬁ r s t a r g u m e n t c o n t r o l s w h e t h e r p o i n t s o r l i n e s w i l l b e 
d r a w n , h o w p i x e l s a r e p u t o n t h e s c r e e n , a n d w h e t h e r 
t h e c o o r d i n a t e s ( t h e o t h e r a r g u m e n t s ) a r e r e l a t i v e o r 
a b s o l u t e . 


C u r r e n t l y a s s i g n e d v a l u e s : 


B i t s 
z e r o 
a n d 
o n e 


0 0 N o c h a n g e i n m e m o r y w h i l e p l o t t i n g ( e . g . M O V E ) 
0 1 P l o t i n g r a p h i c s f o r e g r o u n d c o l o u r 
1 0 
P l o t 
I N V E R T 


1 1 P l o t i n g r a p h i c s b a c k g r o u n d c o l o u r 


B i t 
2 


0 P l o t 
c o o r d i n a t e s 
a r e 
r e l a t i v e 


1 P l o t 
c o o r d i n a t e s 
a r e 
a b s o l u t e 


B i t s 
3 t o 
6 


( a ) B i t 6 c l e a r : l i n e s a n d c u r v e s 
B i t 
3 c l e a r 
- p l o t 
b o t h 
e n d p o i n t s 


s e t 
- p l o t 
ﬁ r s t 
e n d p o i n t 
t w i c e 


Bit 4 clear - 
plot 
c o n t i n u o u s 


set 
- 
plot 
d o t t e d 


Bit 5 clear - 
plot 
l 
i 
n 
e 


set 
- 
plot 
curve ***FUTURE EXPANSION*** 
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( b ) 
B i t 
6 s e t : 
p l o t 
s p e c i a l 
o b j e c t s 


M o d e s & 4 0 t o & 4 7 p l o t p o i n t 
M o d e s & 5 0 t o & 5 7 p l o t a n d ﬁ l l t r i a n g l e 
E x a m p l e P L 0 T & 4 1 , X , Y p l o t s a p o i n t a t X , Y 


P L O T K , X , Y 


P O I N T 
A f u n c t i o n r e t u r n i n g t h e l o g i c a l c o l o u r o f t h e p o i n t o n 
t h e 
s c r e e n 
o r 
- 1 
i f 
o f f 
s c r e e n . 


P R I N T P O I N T ( 1 0 0 , 1 0 0 ) 


A f u n c t i o n 
r e t u r n i n g 
t h e 
h o r i z o n t a l 
p o s i t i o n 
o f 
t h e 


c u r s o r 
o n 
t h e 
s c r e e n ; 
l e f t 
h a n d 
c o l u m n 
i s 
0 . 
S e e 
C O U N T 


f o r p r i n t e r c o m p a t i b l e v e r s i o n . 


X = P 0 S 


P O S 


P R I N T 
A s t a t e m e n t . 
P R I N T 
h a s 
a p a i r 
o f 
l o c a l 
v a r i a b l e s 


P R I N T S a n d P R I N T F ( p r i n t s i z e a n d p r i n t ﬂ a g ) w h i c h c a n 
b e s e t o r u n s e t b y v a r i o u s d e l i m i t e r s . T h e v a r i a b l e @ % 
c o n t r o l s 
n u m e r i c 
p r i n t 
f o r m a t 
a n d 
s p a c i n g 
o f 
ﬁ e l d 


o u t p u t b y P R I N T, t h e b y t e s o f @ % f r o m I s b u p w a r d s w i l l 
b e 
r e f e r r e d 
t o 
a s 
ﬂ , 
f 2 , 
f 3 
a n d 
f 4 . 
F o r 
a d e s c r i p t i o n 


o f 
t h e 
a c t i o n 
o f 
f 4 
s e e 
S T R $ . 
f 3 
s e l e c t s 
t h e 
n u m e r i c 


f o r m a t 
m o d e : 


0 g e n e r a l ( G ) m o d e 
1 e x p o n e n t 
( E ) 
m o d e 


2 ﬁ x e d 
( F ) 
m o d e 


T h e 
i n i t i a l 
m o d e 
i s 
G m o d e . 


f 2 
c o n t r o l s 
t h e 
n u m b e r 
o f 
d i g i t s 
i n 
a m o d e . 
I f 
i t 
i s 


o u t o f r a n g e t h e n 9 i s a s s u m e d . I n G m o d e i t s p e c i ﬁ e s 
t h e m a x i m u m n u m b e r o f d i g i t s t o b e p r i n t e d b e t w e e n 1 
a n d 
9 . 
I n 
E m o d e 
i t 
s p e c i ﬁ e s 
t h e 
e x a c t 
n u m b e r 
o f 


d i g i t s 
t o 
b e 
p r i n t e d 
b e t w e e n 
1 a n d 
9 . 
I n 
F m o d e 
i t 


s p e c i ﬁ e s 
t h e 
n u m b e r 
o f 
d i g i t s 
t o 
f o l l o w 
t h e 
d e c i m a l 


p o i n t , b e t w e e n 0 a n d 9 . 
E m o d e w i l l p r i n t a n o p t i o n a l 
d e c i m a l p o i n t , f 2 - l d i g i t s , a n E a n d a n e x p o n e n t ﬁ e l d 
in 3characters, paddedw i t h 
t r a i l n g 


n e c e s s a r y . 
T h e 
G m o d e 


i n t e g e r s , n u m b e r s i n t h e r a n g e 0 . 1 
n u m b e r s 
l e s s 
t h a n 
. 1 
o r 


e x p o n e n t o f a s f e w c h a r a c t e r s a s p o s s i b l e , 
p r i n t n u m b e r s w i t h f 2 d i g i t s a f t e r t h e " . 
t o t a l 
w h i c h 
c a s e 
G m o d e 
i s 
u s e d . 


s i g n , 
o n e 
d i g i t , 
a 


s p a c e s i f 


w i l l 
p r i n t 
i n t e g r a l 
v a l u e s 
a s 


t o 
1 a s 
0 . 1 
e t c , 


g r e a t e r t h a n l E f 2 w i t h a n 


F m o d e 
w i l l 


u n l e s s 
t h e 


n u m b e r w o u l d t h e n h a v e m o r e t h a n n i n e d i g i t s i n 


I t 
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I 


E x a m p l e s ( a l l s h o w n r i g h t j u s t i ﬁ e d ) 
n u m b e r 
G 2 
G 9 
F 2 
E 2 


. 1 
0 . 1 0 


0 . 0 1 
0 . 0 0 
0 . 0 1 


1 . 0 0 


1 0 . 0 0 


1E2 
100 
1 
0 
0 
. 
0 
0 


Initially, and every time a 
i s 
e n c o u n t e r e d , 


i s s e t t o ﬂ . I n i t i a l l y a n d e v e r y t i m e e i t h e r 


i s e n c o u n t e r e d , P R I N T F i s s e t t o f a l s e . W h e n a 


i s 
e n c o u n t e r e d 
P R I N T F 
i s 
s e t 
t o 
t r u e . 
W h e n 
a 


e n c o u n t e r e d 
a n e w 
l i n e 
i s 
g e n e r a t e d . 
W h e n 
a 


e n c o u n t e r e d , t h e n 0 o r m o r e s p a c e s a r e o u t p u t s o t h a t 
t h e c u r r e n t p r i n t p o s i t i o n i s a m u l t i p l e o f ﬂ . W h e n a 


i s 
e n c o u n t e r e d 
P R I N T S 
i s 
s e t 
t o 
z e r o . 
W h e n 
a 


n u m e r i c 
v a l u e 
i s 
t o 
b e 
p r i n t e d , 
i t 
i s 
p r i n t e d 
i n 


h e x a d e c i m a l n o t a t i o n i f P R I N T F i s t r u e , a n d i n d e c i m a l 
n o t a t i o n o t h e r w i s e . A n u m e r i c v a l u e i s p r i n t e d r i g h t 
j u s t i ﬁ e d 
i n 
a ﬁ e l d 
o f 
s i z e 
P R I N T S ; 
i f 
t h e r e 
i s 
n o t 


e n o u g h 
s p a c e 
i n 
t h e 
ﬁ e l d 
( e . g . 
P R I N T S 
i s 
0 ) 
t h e n 
i t 


i s p r i n t e d i n t h e m i n i m u m n u m b e r o f c h a r a c t e r s p o s s i b l e 
( t r a i l i n g 
s p a c e s 
i n 
E m o d e 
a r e 
p r i n t e d ) . 
A s t r i n g 


v a l u e 
i s 
p r i n t e d 
w i t h 
n o 
e x t r a 
c h a r a c t e r s 
a t 
a l l . 
I f 


t h e l a s t n o n - s p a c e c h a r a c t e r i n t h e P R I N T s t a t e m e n t i s 
n o t a " ; " t h e n a n e w l i n e w i l l b e g e n e r a t e d . 


Examples 
R 
e 
s 
u 
l 
t 


@ % = & 0 0 0 9 0 A 
P R I N T 1 , 2 
P R I N T 1 0 , 2 0 0 
P R I N T 1 0 ; 2 0 0 
P R I N T " A n s w e r ” ; A 
P R I N T " A n s w e r 
" A 


P R I N T " A n s w e r " , A 
P R I N T " H e l l o " , " H e l l o " 
P R I N T " H e l l o " ; " H e l l o 
P R I N T 1 " 2 0 


0 . 1 
0 . 1 
l . O E - 1 
l . O E - 2 
l . O E - 3 


5 . 0 E - 3 
l . O E O 


l . O E l 
1 . 0 E 2 


. 0 1 
l E - 2 


l E - 3 


5 E - 3 


l E - 2 


l E - 3 


5 E - 3 


. 0 0 1 
. 0 0 5 


1 
1 
1 


1 0 
1 0 
1 0 


1 0 0 


P R I N T S 


I I 
I I 


o 
r 
f 


I I ● I I 
I I 
~ I ! 


/ 


I I 
I I 
i 
s 


I I 
I t 
i s 
f 


I I , 
I I 


f 


1 
2 


1 0 
2 0 0 


1 0 2 0 0 


A n s w e r 
4 2 


A n s w e r 


A n s w e r 
H e l l o 
H e l l o 


H e l l o H e l l o 


4 2 


4 2 


I I 


1 


2 0 


A s t a t e m e n t 
w h i c h 
w r i t e s 
t h e 
i n t e r n a l 
f o r m 
o f 
a v a l u e 


o u t 
t o 
a s e q u e n t i a l 
ﬁ l e . 


P R I N T # E , A , B , C , D $ , E $ , F $ 


P R I N T # 
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P R O C 
A r e s e r v e d 
w o r d 
u s e d 
a t 
t h e 
s t a r t 
o f 
a l l 
u s e r 
d e c l a r e d 


p r o c e d u r e s . A n y n u m b e r o f p a r a m e t e r s , i n c l u d i n g z e r o , 
m a y b e p a s s e d ; t h e y a r e p a s s e d b y v a l u e . T h e p r o c e d u r e 
d o e s 
n o t 
h a v e 
t o 
b e 
d e c l a r e d 
b e f o r e 
i t 
i s 
c a l l e d . 


I N P U T " N u m b e r o f d i s c s " F 
P R O C H A N O I ( F , l , 2 , 3 ) 
E N D 
DEF PROCHANOI(A,B,C,D) IFA=0 ENDPROC 
PROCHANOI(A-1,B,D,C) 
P R I N T " M o v e d i s k " ; A 
PROCHANOI(A-1,D,C,B) 
E N D P R O C 


I I 
f r o m p i l e " ; B 


I I 
t o 
p i l e 
" ; C 


P T R # 
A p a i r 
o f 
s t a t e m e n t 
a n d 
f u n c t i o n 
w h i c h 
a l l o w 
t h e 


p r o g r a m m e r t o s e l e c t t h e n e x t b y t e t o b e t r a n s f e r r e d 
t o / f r o m 
a ﬁ l e 
a n d 
t h u s 
e n a b l e s 
r a n d o m 
a c c e s s . 
T h i s 


d o e s 
n o t 
w o r k 
w i t h 
c a s s e t t e 
ﬁ l e s . 


P T R # A = P T R # A - 2 0 


A f u n c t i o n w h i c h c o n v e r t s d e g r e e s t o r a d i a n s . 


X = R A D ( Y ) 
X = S I N R A D ( 9 0 ) 


R A D 


R E A D 
A s t a t e m e n t w h i c h w i l l a s s i g n t o v a r i a b l e s v a l u e s r e a d 
f r o m t h e D ATA s t a t e m e n t s i n t h e p r o g r a m . S t r i n g s m u s t 
b e e n c l o s e d i n d o u b l e q u o t e s i f t h e y h a v e l e a d i n g 
s p a c e s o r c o n t a i n c o m m a s . 


READ C,D,A$ 


R E M 
A s t a t e m e n t 
t h a t 
c a u s e s 
t h e 
r e s t 
o f 
t h e 
l i n e 
t o 
b e 


i g n o r e d . 


R E N U M B E R 
A c o m m a n d w h i c h w i l l r e n u m b e r t h e l i n e s a n d c o r r e c t t h e 
c r o s s 
r e f e r e n c e s 
i n s i d e 


AUTO. RENUMBER produces messages when across reference 
f a i l s . 


p r o g r a m . 
O p t i o n s 
a s 
f o r 
a 


R E N U M B E R 


R E N U M B E R 1 0 0 0 


R E N U M B E R 1 0 0 0 , 5 


(C) Copyright BBC September 1982 Page 21 


R E P E A T 
A s t a t e m e n t 
w h i c h 


R E P E AT. . . U N T I L l o o p , 
m a x i m u m d e p t h o f 2 0 . 


y o u 
UNTIL TRUE will "pop" the stack, 
h a v e m o r e t h a n o n e U N T I L . 


R E P E A T 
A = A + 1 ; U N T I L A > B 


R E P E A T 


X = X + 1 0 
P R I N T " W h a t d o y o u t h i n k o f i t s o f a r ? 
U N T I L 
X > 4 5 


i s 
t h e 
s t a r t i n g 
p o i n t 
o f 
a 


These loops may be nested up to a 
L e a v i n g a l o o p w i t h G O T O b r i n g s 


i n t o E x t e n d e d R a n g e , t h e l o o p c a n b e r e e n t e r e d . 


A s i n g l e R E P E AT m a y 


R E P O R T 
Astatement which prints out anewline followed by the 
e r r o r 
s t r i n g 
a s s o c i a t e d 
w i t h 
t h e 
l a s t 
e r r o r 
w h i c h 


o c c u r r e d . 


R E S T O R E 
RESTORE can be used at any time in aprogram to set the 
place where DATA comes from. The optional parameter 
f o r R E S TO R E c a n s p e c i f y a c a l c u l a t e d l i n e n u m b e r. 


R E S T O R E 


R E S T O R E 1 0 0 


R E S T O R E ( 1 0 * A + 2 0 ) 


R E T U R N 
A s t a t e m e n t c a u s i n g a R E T U R N t o t h e s t a t e m e n t a f t e r t h e 
m o s t 
r e c e n t 
G O S U B 
s t a t e m e n t . 


R I G H T $ 
A s t r i n g f u n c t i o n w h i c h r e t u r n s t h e r i g h t n 
o f t h e s t r i n g , 
t h e s t r i n g t h e n a l l a r e r e t u r n e d . 


A $ = R I G H T $ ( A $ , 2 ) 
A$=RIGHT$(LEFT$(A$,3),2) 


c h a r a c t e r s 


I f 
t h e r e 
a r e 
i n s u f ﬁ c i e n t 
c h a r a c t e r s 
i n 


R N D 
A f u n c t i o n w i t h o p t i o n a l p a r a m e t e r . R N D ( l ) r e t u r n s a 
r e a l n u m b e r i n t h e r a n g e 0 . 0 t o . 9 9 9 9 9 9 9 9 . R N D r e t u r n s 
a r a n d o m i n t e g e r 0 - & F F F F F F F F . R N D ( n ) r e t u r n s a n 
i n t e g e r i n t h e r a n g e 1 t o n . I f n i s n e g a t i v e t h e 
p s e u d o r a n d o m s e q u e n c e g e n e r a t o r i s s e t t o a n u m b e r 
b a s e d 
o n 
n a n d 
n i s 
r e t u r n e d . 
I f 
n i s 
0 t h e 
l a s t 


random number is returned in RND(l) form. 


X = R N D ( 1 ) 
X % = R N D 


N = R N D ( 6 ) 


R U N 
S t a r t e x e c u t i o n o f t h e p r o g r a m , 
s o 
p r o g r a m s 
c a n 
r e e x e c u t e 
t h e m s e l v e s , 


except @% to Z% are CLEARed by RUN. 


R U N 
i s 
a s t a t e m e n t 
a n d 


A l l 
v a r i a b l e s 
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A s t a t e m e n t 
w h i c h 
s a v e s 
t h e 
c u r r e n t 
p r o g r a m 
a r e a 
t o 
a 


ﬁ 
l 
e 
. 


S A V E 


I I 
S A V E 
" F R E D 


S AV E A $ 


A f u n c t i o n r e t u r n i n g - 1 f o r n e g a t i v e a r g u m e n t , 0 f o r 
a r g u m e n t a n d + 1 f o r p o s i t i v e a r g u m e n t . 


X = S G N ( Y ) 


0 
S G N 


A f u n c t i o n g i v i n g t h e s i n e o f i t s r a d i a n a r g u m e n t . 


X = S I N ( Y ) 


S I N 


A s t a t e m e n t t a k i n g 4 p a r a m e t e r s , c o n s i d e r e d b y B A S I C t o 
be 
16 bit words. 
T h e s e 
p a r a m e t e r s 
a r e 
c h a n n e l , 


e n v e l o p e / a m p l i t u d e , f r e q u e n c y ( p i t c h ) a n d d u r a t i o n . 
T h e v a l u e s a r e p a s s e d s t r a i g h t t o t h e M a c h i n e O p e r a t i n g 
S y s t e m . I f t h e s e c o n d p a r a m e t e r i s i n t h e r a n g e - 1 5 t o 
0 
t h e n 
i t 
s e l e c t s 
a c o n s t a n t 
a m p l i t u d e 
( - 1 5 
i s 


l o u d e s t ) ; i f i t i s p o s i t i v e i t s e l e c t s a n e n v e l o p e . 


S O U N D 1 , - 1 5 , M I D D L E C , Q U AV E R 


S O U N D 


A f u n c t i o n w h i c h c a n o n l y b e u s e d i n P R I N T o r I N P U T . 
S P C o u t p u t s n M O D 2 5 6 s p a c e s w h e r e n i s t h e a r g u m e n t . 


P R I N T D A T E ; S P C ( 6 ) ; S A L A R Y 


S P C 


A f u n c t i o n 
r e t u r n i n g 
t h e 
s q u a r e 
r o o t 
o f 
i t s 
a r g u m e n t . 


X = S Q R ( Y ) 


S Q R 


P a r t 
o f 
t h e 
F O R 
s t a t e m e n t , 
t h i s 
o p t i o n a l 
s e c t i o n 


s p e c i ﬁ e s s t e p s i z e s o t h e r t h a n 1 . 


S T E P 


S y n t a c t i c a l l y 
i d e n t i c a l 
t o 
E N D , 
S T O P 
a l s o 
p r i n t s 
a 


m e s s a g e t o t h e e f f e c t t h a t t h e p r o g r a m h a s s t o p p e d . 


S T O P 


STR$ 
A s t r i n g f u n c t i o n w h i c h r e t u r n s t h e s t r i n g f o r m o f t h e 
n u m e r i c a r g u m e n t a s i t w o u l d h a v e b e e n p r i n t e d . T h e 
m s b o f @ % , i f n o n z e r o , l e t s S T R $ u s e t h e c u r r e n t @ % 
d e s c r i p t i o n 
f o r 
p r i n t i n g 
n u m b e r s , 
i f 
z e r o 
( t h e 
i n i t i a l 


v a l u e ) t h e n G 9 f o r m a t ( s e e P R I N T ) i s u s e d . 


A $ = S T R $ ( P I ) 
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S T R I N G $ 
A f u n c t i o n 
r e t u r n i n g 
N c o n c a t e n a t i o n s 
o f 
a s t r i n g . 


A $ = S T R I N G $ ( N , " h e l l o " ) 
B $ = S T R I N G $ ( 1 0 , " - * - " ) 
C$=STRING$(Z%,S$) 


A f u n c t i o n 
a v a i l a b l e 
i n 
P R I N T 
o r 
I N P U T . 
T A B ( X ) 
w i l l 


a t t e m p t t o m a k e C O U N T e q u a l t o X b y p r i n t i n g a n e w l i n e 
i f r e q u i r e d p l u s s o m e s p a c e s . T A B ( X , Y ) w i l l p e r f o r m a 
c u r s o r m o v e o n t h e V D U s c r e e n t o c h a r a c t e r c e l l X , Y i f 
p o s s i b l e . T h e l e f t m o s t c o l u m n i s c o l u m n 0 . 


P R I N T T A B ( 1 0 ) ; A $ 
P R I N T TA B ( X , Y ) ; B $ 


T A B 


A f u n c t i o n 
g i v i n g 
t h e 
t a n g e n t 
o f 
i t s 
r a d i a n 
a r g u m e n t . 


X = T A N ( Y ) 


T A N 


P a r t 
o f 
t h e 
I F 
T H E N 
. . . 
E L S E 
s t a t e m e n t . 
T H E N 
● 
● 
● 


A p s e u d o - v a r i a b l e w h i c h r e a d s a n d s e t s t h e l o w e r f o u r 
b y t e s o f t h e c o m p u t a t i o n a l e l a p s e d t i m e c l o c k . 


X = T I M E 


T I M E = 1 0 0 


T I M E 


A f u n c t i o n 
w h i c h 
r e t u r n s 
t h e 
v a l u e 
o f 
t h e 
ﬁ r s t 
f r e e 


l o c a t i o n 
a f t e r 
t h e 
e n d 
o f 
t h e 
c u r r e n t 
t e x t . 
T h u s 
t h e 


l e n g t h o f t h e p r o g r a m i s g i v e n b y T O P - PA G E . 


P R I N T 
T O P - P A G E 


T O P 


P a r t 
o f 
t h e 
F O R 
. . . 
T O 
. . . 
S T E P 
s t a t e m e n t . 
T O 


T R A C E O N c a u s e s t h e i n t e r p r e t e r t o p r i n t e x e c u t e d l i n e 
n u m b e r s 
w h e n 
i t 
e n c o u n t e r s 
t h e m . 
T R A C E 
X s e t s 
a l i m i t 


o n t h e s i z e o f l i n e n u m b e r s w h i c h m a y b e p r i n t e d o u t , 


T h u s 
a c a r e f u l 


T R A C E 


o n l y 
t h o s e 
l e s s 
t h a n 
X w i l l 
a p p e a r , 


u s e r 
w i t h 
a l l 
s u b r o u t i n e s 
a t 
t h e 
e n d 
o f 
t h e 
m a i n 


p r o g r a m c a n p r e v e n t t r a c e d o u t p u t o f s u b r o u t i n e c a l l s . 
T R A C E O F F t u r n s t r a c e o f f . N o t e , t h a t t h e i n t e r p r e t e r 
d o e s n o t e x e c u t e l i n e n u m b e r s v e r y o f t e n ; - 


T R A C E o u t p u t 
P r o g r a m 


1 0 
F O R Z = 0 T O 1 0 0 


2 0 Q = Q * Z : N E X T 


3 0 
E N D 


B u t t h i n g s w o u l d b e d i f f e r e n t w e r e N E X T o n l i n e 2 5 , 
TRACE output would be [10] 
[20] 
[25] 
[25] 
[25] 
[ 
2 
5 
] 


[ 3 0 ] 


[10] 
[20] 
[ 
3 
0 
] 


[25] 
[25] 
[25] 
[ 
2 
5 
] 


( C ) C o p y r i g h t B B C S e p t e m b e r 1 9 8 2 P a g e 2 4 


> 


A f u n c t i o n h a v i n g a t r u e v a l u e ( - 1 ) . 
T R U E 


A p a r t o f t h e R E P E A T . . . 
U N T I L 
U N T I L 
s t r u c t u r e . 


A f u n c t i o n 
a l l o w i n g 
m a c h i n e 
c o d e 
t o 
r e t u r n 
a v a l u e 


d i r e c t l y f o r t h i n g s w h i c h d o n o t r e q u i r e t h e e x p e n s e o f 
C A L L , 
a d d r e s s i s i t s a r g u m e n t w i t h t h e p r o c e s s o r " ' s A , X a n d Y 
r e g i s t e r s 
a n d 
t h e 
C c a r r y 
ﬂ a g 
i n i t i a l i s e d 
a s 
i n 
C A L L 


a n d r e t u r n s a 3 2 b i t i n t e g e r c o m p o s e d o f P Y X A m s b t o 
I s b . 


U S R 


U S R 
c a l l s 
t h e 
m a c h i n e 
c o d e 
s u b r o u t i n e 
w h o s e 


X = U S R ( L I F T D O W N ) 


A f u n c t i o n 
w h i c h 
c o n v e r t s 
a c h a r a c t e r 
s t r i n g 


r e p r e s e n t i n g 
a n u m b e r 
i n t o 
n u m e r i c 
f o r m . 
U n l e s s 
t h e 


a r g u m e n t i s a u n a r y s i g n e d c o n s t a n t V A L r e t u r n s 0 . 


X=VAL(A$) 


V A L 


A s t a t e m e n t w h i c h t a k e s a l i s t o f n u m e r i c a g r u m e n t s a n d 
s e n d s 
t h e m 
t o 
O S W R C H . 
A w o r d 
c a n 
b e 
s e n t 
i f 
t h e 
v a l u e 


is followed by a 
T h e 
b y t e s 
s e n t 
D O 
N O T 
c o n t r i b u t e 


t o t h e v a l u e o f C O U N T, b u t m a y w e l l c h a n g e P O S a n d V P O S 
( e . g . V D U 3 0 w o u l d h o m e t h e c u r s o r ) . 


V D U 2 8 , 0 , 3 1 , 3 2 , 0 ; R E M 
d e ﬁ n e 
w i n d o w 


V D U 2 7 , 0 ; 0 ; 1 2 8 0 ; 1 0 2 4 ; 


V D U 


V P O S 
A f u n c t i o n 
r e t u r n i n g 
t h e 
v e r t i c a l 
c u r s o r 
p o s i t i o n , 


t o p o f t h e s c r e e n i s l i n e 0 . 


X = V P O S 


T h e 


W I D T H 
A s t a t e m e n t 
c o n t r o l l i n g 
o u t p u t 
o v e r a l l 
ﬁ e l d 
w i d t h . 


T h e i n i t i a l v a l u e i s W I D T H 0 w h e n t h e i n t e r p r e t e r w i l l 
n o t a t t e m p t t o c o n t r o l t h e o v e r a l l ﬁ e l d w i d t h . W I D T H 
n w i l l 
c a u s e 
t h e 
i n t e r p r e t e r 
t o 
f o r c e 
a n e w l i n e 
a f t e r 
n 


M O D 2 5 6 c h a r a c t e r s h a v e b e e n p r i n t e d . 


W I D T H 
6 0 
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O p e r a t o r s a n d s p e c i a l s y m b o l s . 


! 
Aunary and binary operator giving 32 bit indirection. 


A u n a r y a n d b i n a r y o p e r a t o r g i v i n g 8 b i t i n d i r e c t i o n . 


A d e l i m i t i n g c h a r a c t e r i n s t r i n g s , 
e v e n 
n u m b e r 
o f 


by the escape convention 


I n d i c a t e s 


? 


S t r i n g s a l w a y s h a v e 


may be introduced into astring 


a 
n 


i n 
t h e m . 


I I 
I I 


i m m e d i a t e o p e r a t i o n i n a s s e m b l e r ; p r e c e d e s 


reference to aﬁle channel number (and is not optional). 


Acharacter indicating that the object has something to do 
with astring. The syntax $<expression> may be used to 
p o s i t i o n a s t r i n g a n y w h e r e i n 
i n t e r p r e t e r ' s s p a c e a l l o c a t i o n , 
n a m e i t i n d i c a t e s a s t r i n g v a r i a b l e . 


Asufﬁx on avariable name indicating an integer 


$ 


o v e r r i d i n g t h e 


A s 
a s u f ﬁ x 
o n 
a v a r i a b l e 


m e m o r y , 


% 
v a r i a b l e . 


Precedes hexadecimal constants e.g. &EF 


& 


Acharacter which causes newlines in PRINT or INPUT. 


Objects in parentheses have highest priority. 


" B e c o m e s 


( 
) 


for LET statement and FOR, 


relation of equal to on integers. 


Unary negation and binary subtraction on integers and reals, 


o n i n t e g e r s a n d r e a l s ; 


indicating operating system command. 


M u l t i s t a t e m e n t l i n e s t a t e m e n t d e l i m i t e r . 


Suppresses forthcoming action in PRINT or INPUT. 


U n a r y p l u s a n d b i n a r y a d d i t i o n 
c o n c a t e n a t i o n b e t w e e n s t r i n g s . 


D e l i m i t e r 
i n 
l i s t s . 


D e c i m a l p o i n t i n 
keyword entry; introduce label in assembler. 


Relation of less than on integers, reals and strings. 


Relation of greater than on integers. 


Binary division on integers and reals. 


r e s u l t 
i s " 


r e a l s a n d s t r i n g s . 


f o r F N , 


* 
B i n a r y m u l t i p l i c a t i o n 
s t a t e m e n t 


+ 
o n i n t e g e r s a n d r e a l s ; 


r e a l 
c o n s t a n t s ; 
a b b r e v i a t i o n 
s y m b o l 
o n 


< 


> 
r e a l s a n d s t r i n g s . 


/ 
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R e l a t i o n 
o f 
l e s s 
t h a n 
o r 
e q u a l 
o n 
i n t e g e r s , 
r e a l s 
a n d 


s t r i n g s . 


< 
= 


R e l a t i o n 
o f 
g r e a t e r 
t h a n 
o r 
e q u a l 
o n 
i n t e g e r s , 
r e a l s 
a n d 


s t r i n g s . 


R e l a t i o n o f n o t e q u a l o n i n t e g e r s , r e a l s a n d s t r i n g s . 


> 
= 


< 
> 


[ 
] 
D e l i m i t e r s 
f o r 
a s s e m b l e r 
s t a t e m e n t s , 


t h e s e 
d e l i m i t e r s 
w i l l 
n e e d 
t o 
b e 
a s s e m b l e d 
t w i c e 
i n 
o r d e r 
t o 


r e s o l v e a n y f o r w a r d r e f e r e n c e s . T h e p s e u d o o p e r a t i o n O P T 
( i n i t i a l l y 3 ) c o n t r o l s e r r o r s a n d l i s t i n g . 


E x a m p l e ; 


1 0 
o s w r c h = & F F F 4 


2 0 
F O R Z = l T O 3 S T E P 2 : P % = T O P + 1 0 0 0 


3 0 
[ o p t 
Z ; . s t a r t 
I d a 
# A S C " ! " 


4 0 
I d x 
# 4 0 


5 0 . l o o p j s r o s w r c h 
6 0 d e x : b n e l o o p 
7 0 
r t s : ] 
N E X T 


8 0 
C A L L 
s t a r t 


9 0 
E N D 


S t a t e m e n t s 
b e t w e e n 


B i n a r y o p e r a t i o n o f e x p o n e n t i a t i o n b e t w e e n i n t e g e r s a n d 
r e a l s . 


A c h a r a c t e r i n t h e s t a r t o f a p r i n t ﬁ e l d i n d i c a t i n g t h a t 
t h e i t e m i s t o b e p r i n t e d i n h e x a d e c i m a l . 


E x p r e s s i o n P r i o r i t y : 


(1) variables, functions () ! 
( 2 ) ^ 
( 3 ) 
* / M O D 
D I V 


( 4 ) 
+ - 


& , 
u n a r y 
+ - N O T 


( 5 ) 
< > 
< = > = > < 


( 6 ) A N D 
( 7 ) E O R O R 


E x a m p l e s o f u s e o f t h e p r i o r i t y 


I F 
A = 2 
A N D 
B = 3 
T H E N 


A = ? C A N D & F F F 


I F A = 1 
O R 
C = 2 A N D 
B = 3 
T H E N 


IF NOT(A=l AND B=2) THEN 


I F ( ( A = 2 ) A N D ( B = 3 ) ) T H E N 
A = ( ( ? C ) A N D ( & F F F ) ) 
I F ( ( A = l ) O R ( ( C = 2 ) A N D ( B = 3 ) ) ) T H E N 
I F ( N O T ( ( A = l ) A N D ( B = 2 ) ) ) T H E N 


C h a r a c t e r s p e r m i t t e d i n v a r i a b l e n a m e s 


A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 
a b c d e f g h i 
j k l m n o p q r 
s t u v w x y z 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
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% 


E R R O R M E S S A G E S A N D E R R O R C O D E S 


D i r e c t M o d e O n l y ( e r r o r c o d e 0 ) : 


S i l l y 
R E N U M B E R s p a c e 


L I N E s p a c e 


D i s a s t r o u s a n d u n t r a p p a b l e : 


B a d P r o g r a m 
N o 
r o o m 


T r a p p a b l e : 


1 O u t o f r a n g e 
3 I n d e x 
5 M i s s i n g 
, 


7 N o 
F N 


9 M i s s i n g 


1 1 D I M s p a c e 
1 3 N o P R O C 
1 5 S u b s c r i p t 
1 7 E s c a p e 
1 9 S t r i n g t o o l o n g 


2 1 
- v e 
r o o t 


2 3 A c c u r a c y l o s t 
2 5 B a d M O D E 
2 7 M i s s i n g ) 
29 No such FN/PROC 
3 1 A r g u m e n t s 
3 3 C a n ^ t m a t c h F O R 
35 Too many FORs 
37 Too many GOSUBs 
3 9 O N s y n t a x 
4 1 
N o 
s u c h 
l i n e 


4 3 
N o 
R E P E A T 


2 B y t e 
4 M i s t a k e 
6 T y p e m i s m a t c h 
8 $ r a n g e 


1 0 
B a d 
D I M 


1 2 
N o t 
L O C A L 


1 4 
A r r a y 


1 6 
S y n t a x 
e r r o r 


1 8 D i v i s i o n b y z e r o 
2 0 To o b i g 
2 2 L o g r a n g e 
2 4 E x p r a n g e 
2 6 
N o 
s u c h 
v a r i a b l e 


2 8 
B a d 
h e x 


3 0 
B a d 
c a l l 


3 2 
N o 
F O R 


3 4 
F O R 
v a r i a b l e 


3 6 
N o 
T O 


3 8 N o G O S U B 


4 0 O N r a n g e 
4 2 
O u t 
o f 
D A T A 


44 Too many REPEATS 


I I 


T h e f o l l o w i n g w o r d s c a n n o t b e u s e d i n u p p e r c a s e a s t h e s t a r t o f a 
variable name (anything may be used in lower case): 


A N D 


C A L L 


D A T A 


D I V 


E R R O R 


G C O L 


I N K E Y 


L E N 


L O A D 


M O V E 


O P E N I N 


P R I N T 


R E N U M B E R 
R E P E A T 


A S C 
A C S 
A D V A L 
A B S 


C H A I N 
A U T O 


C O L O U R 
C O S 


D E L E T E 
D I M 


E N V E L O P E 
E O R 


A T N 
A S N 


D E G 
CHR$ 


D R A W 


E V A L 


D E F 


E L S E 


G E T 
F O R 
E X P 
F N 


I N P U T 
G O S U B 
I 
F 
G O T O 
I N S T R ( 
L I N E 


LEFT$( 
L E T 
I N T 


L O C A L 


N E X T 


O P E N O U T 


P R O C 


L N 
L I S T 
MID$ ( 
M O D 
L O G 


O N 
N O T 
O F F 


P L O T 


R E A D 


RESTORE RIGHT$( 


SOUND S 
P 
C 


S T R I N G $ ( T A B ( 
TRACE U 
N 
T 
I 
L 


W I D T H 


P O I N T ( 
O R 


R E M 
R A D 


S I N 
S G N 
S A V E 


STR$ 
S T E P 


T H E N 


S Q R 


T O 
T A N 


V D U 
V A L 
U S R 


( C ) C o p y r i g h t B B C S e p t e m b e r 1 9 8 2 P a g e 2 8 


T h e B B C M i c r o c o m p u t e r S y s t e m 


P A R T I I - H A R D W A R E D E S C R I P T I O N 


S e c t i o n 1 - T h e M i c r o c o m p u t e r U n i t 


t h e 
h a r d w a r e 
c h a r a c t e r i s t i c s 
o f 
t h e 


t h e B B C M i c r o c o m p u t e r S y s t e m , a s a g r e e d 


B r i t i s h B r o a d c a s t i n g C o r p o r a t i o n a n d A c o r n C o m p u t e r s 


d e s c r i p t i o n , ﬁ r m w a r e a n d 


T h i s 
d o c u m e n t 
d e s c r i b e s 


M i c r o c o m p u t e r U n i t o f 
b e t w e e n 
t h e 


L i m i t e d . I t f o r m s p a r t o f t h e o v e r a l l 
h a r d w a r e , o f t h e B B C M i c r o c o m p u t e r S y s t e m . 
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THE BBC MICROCOMPUTER SYSTEM 


HARDWARE DESCRIPTION 


Section 1-The Microcomputer Unit 


G E N E R A L 


The machine is designed to the highest engineering standards 


and all component parts are used within the manufacturers 
recommended limits. Particular care has been taken with printed 
circuit layout and supply decoupling. Unused gate inputs are not 
left open-circuit. j i„a 
u 
A l l i t e m s i n t h i s s p e c i ﬁ c a t i o n a p p l y t o t h e M o d e l s A a ® 


BBC Microcomputer unless speciﬁcally indicated otherwise. With 
the sole exception of the Econet interface, integrated circuit 
sockets are ﬁtted in all unequipped positions. 


C A S E 


Dimensions: 412mm wide by 350 mm deep by 70mm high approx. 
Material: Injection moulded thermoplastic. 


C r e a m 
c o l o u r e d 
c a s e 
w i t h 
b l a c k 
k e y b o a r d 
E x t e r n a l 
a p p e a r a n c e : 


e s c u t c h e o n . 


The case is designed to enclose the printed circuit board and 


mains power supply and to provide arigid support for the 
keyboard. It is sufﬁciently strong to withstand rough handling in 
transit, particularly with regard to the mounting of heavy items 
such as the power supplier. _ 
The case is of two-part construction, the lower shell 


supporting the keyboard PCB, the main PCB and the power supply. 
Electrical connection between the main PCB and the keyboard PCB is 
P r e c a u t i o n s h a v e b e e n t a k e n t o p r e v e n t 


e l e c t r i c a l c o u p l i n g b e t w e e n r i b b o n 
by ﬂexible ribbon cable, 
m a l f u n c t i o n 
r e s u l t i n g 
f r o m 


c a b l e 
c o n d u c t o r s . 


All printed circuit boards are copper-on-ﬁbreglass and have 


legends. The main logic board is 
s c r e e n - p r i n t e d c o m p o n e n t 
through-hole—plated and has asolder resist. 
Apertures are provided for expansion connectors 


sufﬁcient ventilation slots to allow for continuous use at a 
local ambient temperature of 35C without subnecting the interna 
components or case material to atemperature in excess of their 
rated maximum (with all expansion options ﬁtted). 


The two parts of the case are secured together by four 
screws. The case is provided with non-slip non scratch feet 
commensurate with its use in adomestic environment 
f u r n i t u r e 
e t c . ) 
. 


p l u s 


m e t a l 


( o n p o l i s h e d 
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E L E C T R I C A L 
S A F E T Y 


T h e 
u n i t 
m e e t s 
t h e 
a p p r o p r i a t e 
B E A B , 
B S I 
a n d 
E u r o p e a n 


s t a n d a r d s 
a n d 
i s 
s o 
m a r k e d . 
I t 
i s 
c o n s t r u c t e d 
i n 
a c c o r d a n c e 
w i t h 


B S I C l a s s 1 r e q u i r e m e n t s , i . e . a l l e x p o s e d m e t a l w o r k i s c o n n e c t e d 
t o e a r t h v i a t h e e a r t h l e a d o f t h e 3 - c o r e m a i n s c a b l e . A l l p o i n t s 
w h i c h c o u l d b e a t m a i n s p o t e n t i a l w h e n p o w e r i s a p p l i e d a r e 
i n a c c e s s i b l e t o t h e " s t a n d a r d ﬁ n g e r " . 


M E C H A N I C A L S A F E T Y 


T h e r e a r e n o s h a r p e d g e s o r c o r n e r s w h i c h c o u l d c a u s e d a m a g e 


t o p e r s o n o r c l o t h i n g w h e n t h e c o v e r s a r e i n p l a c e . 


K E Y B O A R D 


T h e 
k e y b o a r d 
i s 
i n 
s t a n d a r d 
Q W E R T Y 
f o r m a t 
u s i n g 
a p i t c h 


b e t w e e n k e y s a n d b e t w e e n r o w s o f 0 . 7 5 " , w i t h a c o n v e n t i o n a l r o w - 


T h e r e 
a r e 
f o u r 
r o w s 
o f 


a d d i t i o n a l 
t o p 
r o w 
o f 


s o f t w a r e - d e ﬁ n a b l e k e y s , 7 3 k e y s i n a l l . T h e t w o S H I F T k e y s 


a n d t h e R E T U R N k e y a r e a t l e a s t 1 . 5 t i m e s t h e n o r m a l k e y s i z e a n d 
t h e s p a c e b a r i s a p p r o x i m a t e l y 5 . 5 " l o n g w i t h a m e c h a n i s m t o a l l o w 
i t t o b e p r e s s e d w i t h e q u a l e a s e a n y w h e r e a l o n g i t s l e n g t h . T h e 
k e y b o a r d i s ﬁ x e d a t a s t a n d a r d o p e r a t i n g a n g l e . 


T h e r e 
a r e 
f o u r 
c u r s o r - c o n t r o l 
k e y s 
a t 
t h e 
r i g h t - h a n d 
e n d 
o f 


t h e m a i n k e y b o a r d ; L E F T, U P, R I G H T a n d D O W N . T h e k e y b o a r d c a n 
g e n e r a t e a l l A S C I I c o d e s ( 0 / 0 t o 7 / 1 5 ) b y u s i n g t h e S H I F T a n d C T R L 
k e y s i n c o n j u n c t i o n w i t h t h e o t h e r k e y s . T h e s p a c e b a r a n d z e r o 
k e y a r e n o t a f f e c t e d b y d e p r e s s i n g t h e S H I F T k e y . 


k e y s 
h a v e 
p o s i t i v e 
a c t i o n 
w i t h 
a t o t a l 
t r a v e l 
o f 


a p p r o x i m a t e l y 0 . 2 " , t h e k e y p r e s s b e i n g d e t e c t e d a t a p p r o x i m a t e l y 
5 0 % t o t a l t r a v e l . T h e k e y b o a r d h a s t w o - k e y r o l l o v e r o n a l l k e y s 


I t 
i s 
p o s s i b l e 


s o f t w a r e 
c o n t r o l 
t o 
d e t e r m i n e 
w h e t h e r 
a k e y 
i s 
h e l d 


d e p r e s s e d 
o r 
h a s 
b e e n 
r e l e a s e d . 


A R E S E T ( o r B R E A K ) k e y i s p r o v i d e d o n t h e m a i n k e y b o a r d b u t 


c a n b e d i s a b l e d b y c u t t i n g a l i n k o n t h e k e y b o a r d p r i n t e d c i r c u i t 
b o a r d . 


s t a g g e r 
o f 
0 . 3 7 5 " 
a n d 
0 . 1 8 7 5 " . 


a l p h a n u m e r i c k e y s p l u s a s p a c e - b a r a n d a n 
t e n 


T h e 


e x c e p t S H I F T , C T R L , S H I F T L O C K a n d C A P S L O C K , 
u n d e r 


T h e k e y s a r e t w o - s h o t m o u l d i n g s ; b o t h p o u n d s i g n a n d n u m b e r 


s y m b o l ( h a s h ) a r e i n c l u d e d ( t h e d e t a i l e d k e y b o a r d l a y o u t s h o w i n g 
l e g e n d s a n d c o d e s p r o d u c e d i s a t t a c h e d ) . 


T h e k e y b o a r d i s s o f t w a r e s c a n n e d b u t t h i s i s m a d e t r a n s p a r e n t 


t o 
t h e 


t h e p r o c e s s o r 
p r e s s e d . 


u s e r, a n d p r o c e s s i n g o v e r h e a d m i n i m i s e d , b y i n t e r r u p t i n g 


a n d 
s c a n n i n g 
t h e 
k e y b o a r d 
o n l y 
w h e n 
a k e y 
i s 
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P O W E R 
S U P P L Y 


T h e p o w e r s u p p l y a c c e p t s a m a i n s i n p u t o f b e t w e e n 2 2 0 a n d 2 6 0 


v o l t s r m s a t a f r e q u e n c y o f 4 7 - 6 3 H z . T h e t o t a l c o n s u m p t i o n d o e s 
n o t 
e x c e e d 
5 0 V A . 
T h e 
u n i t 
i s 
r a t e d 
t o 
p o w e r 
t h e 
m a c h i n e 


c o n t i n u o u s l y w i t h a l l o n - b o a r d e x p a n s i o n s ﬁ t t e d . T h e p o w e r 
s u p p l y w i l l w i t h s t a n d a n o v e r l o a d i n d e ﬁ n i t e l y a n d w i l l p r o t e c t 
i t s e l f f r o m d a m a g e t h r o u g h o v e r h e a t i n g . 


T h e r e 
a r e 
n o 
e x p o s e d 
m a i n s 
t e r m i n a l s 
w i t h i n 
t h e 
c a s e ; 
t h e 


t h r e e c o r e m a i n s l e a d p r o v i d e d h a s a m o u l d e d - o n p l u g ﬁ t t e d w i t h a 
3 a m p f u s e . 


C O M P O S I T E 
V I D E O 
O U T P U T 


A I v p k - p k ( 7 5 o h m s ) m o n o c h r o m e c o m p o s i t e v i d e o o u t p u t i s 


p r o v i d e d 
o n 
a 7 5 
o h m 
B N C 
s o c k e t 
a c c e s s i b l e 
a t 
t h e 
r e a r 
o f 
t h e 


m a c h i n e . T h e T V s t a n d a r d i s 6 2 5 - l i n e s , 5 0 - ﬁ e l d i n t e r l a c e d , w i t h a 
ﬁ e l d - s y n c p u l s e c o n s i s t i n g o f a s i n g l e b r o a d p u l s e o f 1 2 8 u s 
d u r a t i o n . 
A n 
i n t e r n a l 
m o d i ﬁ c a t i o n 
a l l o w s 
c h r o m i n a n c e 
i n f o r m a t i o n 


t o b e a d d e d t o t h i s o u t p u t . 


U H F 
O U T P U T 


T h e 
U H F 
o u t p u t 
i s 
f r o m 
a n 
A s t e c 
m o d u l a t o r 
ﬁ x e d 
t u n e d 
t o 


a p p r o x i m a t e l y c h a n n e l 3 6 , f o r f e e d i n g t o a d o m e s t i c T V s e t . T h i s 
is negative modulated by aPAL-coded composite video signal. The 
s i g n a l c h a r a c t e r i s t i c s a r e a s d e ﬁ n e d i n t h e p r e v i o u s s e c t i o n w i t h 
the addition of chrominance information at asubcarrier frequency 
o f 4 . 4 3 3 6 1 8 7 5 M H z + / - l O O H z o v e r t h e t e m p e r a t u r e r a n g e 5 - 3 5 C 
( a m b i e n t ) . A 2 m l o n g ﬂ y i n g l e a d i s p r o v i d e d f o r c o n n e c t i o n t o t h e 
T V r e c e i v e r, t e r m i n a t e d b y a s t a n d a r d B e l l i n g L e e p l u g . T h e o t h e r 
e n d o f t h e l e a d i s ﬁ t t e d w i t h a P h o n o p l u g f o r c o n n e c t i o n t o t h e 
m o d u l a t o r t h r o u g h a n a p e r t u r e i n t h e r e a r p a n e l o f t h e c o m p u t e r. 


R G B O U T P U T S ( M o d e l B o n l y ) 


F o u r o u t p u t s a t T T L l e v e l s a r e p r o v i d e d , b e i n g r e d , g r e e n & 


b l u e v i d e o s i g n a l s a n d a c o m p o s i t e ( m i x e d ) s y n c p u l s e s i g n a l . 
T h e s e a r e s u i t a b l e f o r d r i v i n g a h i g h i n p u t i m p e d a n c e R G B m o n i t o r. 
T h e T V s t a n d a r d i s a s p r e v i o u s l y d e ﬁ n e d . T h e c o n n e c t o r f o r t h e s e 
o u t p u t s i s n o t ﬁ t t e d i n t h e M o d e l A m a c h i n e . 
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% 


A U D I O 
C A S S E T T E 
I N T E R F A C E 


A c a s s e t t e m o d e m i s i n c o r p o r a t e d t o a l l o w s t o r a g e o f p r o g r a m s 


a n d 
d a t a 
o n 
a s t a n d a r d 
a u d i o 
c a s s e t t e 
r e c o r d e r , 
m o n o 
o r 
s t e r e o . 


T h e f o r m a t i s a s y n c h r o n o u s s e r i a l d a t a w i t h o n e s t a r t b i t ( s p a c e ) , 
e i g h t 
d a t a 
b i t s 
( L S B 
ﬁ r s t ) 
a n d 
o n e 
s t o p 
b i t 
( m a r k ) 
p e r 
b y t e 
a t 


o n e o f t w o a l t e r n a t i v e s p e e d s , 3 0 0 b a u d a n d 1 2 0 0 b a u d . I n t h e 
l o w - s p e e d 
m o d e 
a M A R K 
b i t 
( l o g i c 
1 ) 
i s 
e n c o d e d 
a s 
8 c y c l e s 
o f 


2 4 0 0 H z t o n e a n d a S P A C E ( l o g i c 0 ) a s 4 c y c l e s o f 1 2 0 0 H z t o n e . I n 
high-speed mode aMARK is 2cycles of 2400Hz tone and aSPACE is 1 
c y c l e o f 1 2 0 0 H z t o n e . I t i s p o s s i b l e t o s w i t c h b e t w e e n l o w - s p e e d 
( C U T S ) m o d e a n d h i g h - s p e e d m o d e u n d e r s o f t w a r e c o n t r o l , w i t h o u t 
i n t e r n a l 
m o d i ﬁ c a t i o n . 


T h e d e m o d u l a t o r i s i n s e n s i t i v e t o i n p u t l e v e l v a r i a t i o n s o f u p 


t o + 6 d B o r - 1 2 d B a n d r e c o v e r s t h e U A R / T c l o c k f r o m t h e t a p e i n 
o r d e r t o t r a c k s h o r t a n d l o n g - t e r m s p e e d v a r i a t i o n s . I t c a t e r s 
f o r a n i n s t a n t a n e o u s s p e e d e r r o r o f a t l e a s t 1 0 % W I T H O U T r e l y i n g 
o n t h e i n h e r e n t i n s e n s i t i v i t y t o s p e e d o f a s y n c h r o n o u s d a t a , i . e . 
b i t - c e n t r e s a m p l i n g i s m a i n t a i n e d . T h e d e m o d u l a t o r i s i n s e n s i t i v e 
t o p h a s e o f t h e p l a y e d - b a c k s i g n a l . 


I n p u t a n d o u t p u t l e v e l s a r e s t a n d a r d D I N . A p p r o p r i a t e l o w - 


p a s s 
ﬁ l t e r i n g 
i s 
i n c o r p o r a t e d 
i n 
t h e 
o u t p u t 
t o 
a v o i d 
s u b j e c t i n g 


t h e c a s s e t t e r e c o r d e r t o h i g h - f r e q u e n c y c o m p o n e n t s w h i c h c o u l d 
c a u s e 
o v e r l o a d i n g 
o r 
o t h e r 
f o r m s 
o f 
d i s t o r t i o n . 
T h e 
i n p u t 


c i r c u i t r y 
i n c o r p o r a t e s 
b a n d - p a s s 
ﬁ l t e r i n g 
t o 
r e d u c e 
t h e 


s e n s i t i v i t y o f t h e d e m o d u l a t o r t o h i g h a n d l o w f r e q u e n c y n o i s e , 
h u m 
e t c . 


T h e c a s s e t t e c o n n e c t o r i s a s e v e n - p i n D I N s o c k e t w i r e d s o t h a t 


i f a s t e r e o r e c o r d e r i s u s e d b o t h c h a n n e l s a r e r e c o r d e d b u t r e p l a y 
i s f r o m t h e l e f t c h a n n e l o n l y . 


A r e l a y i s i n c l u d e d i n t h e b a s i c m a c h i n e w h i c h c a n b e u s e d t o 


s w i t c h 
t h e 
c a s s e t t e 
r e c o r d e r 
t a p e - t r a n s p o r t 
m o t o r 
o n 
a n d 
o f f . 


T h i s r e l a y i s a d e q u a t e l y r a t e d t o s w i t c h l o a d s w h i c h a r e h i g h l y 
i n d u c t i v e . T h e r e l a y i s d r i v e n b y t h e o p e r a t i n g s y s t e m s o a s t o 
a l l o w 
t h e 
e a s y 
s t o r a g e 
a n d 
r e c a l l 
o f 
c a s s e t t e 


C o n n e c t i o n s t o t h e r e l a y c o n t a c t s a r e b r o u g h t t o p i n s 6 & 7 o f t h e 
D I N 
c o n n e c t o r . 


d a t a 
ﬁ l e s . 


R S 4 2 3 S E R I A L I N T E R FA C E ( M o d e l B o n l y ) 


W h e n t h e c a s s e t t e i n t e r f a c e i s n o t i n u s e , t h e s e r i a l p o r t i s 


a v a i l a b l e 
t o 
p r o v i d e 
a b i - d i r e c t i o n a l 
R S 4 2 3 
( + / - 5 v ) 
i n t e r f a c e 
f o r 


d r i v i n g 
a s e r i a l 
p r i n t e r 
e t c . 
P r o v i s i o n 
i s 
m a d e 
o n 
t h e 
m a i n 
P C B 


t o i n c l u d e t h e n e c e s s a r y i n t e r f a c e i . c ^ s b u t n e i t h e r t h e s e n o r t h e 
c o n n e c t o r 
a r e 
ﬁ t t e d 
i n 
t h e 
M o d e l 
A m a c h i n e , 


s e l e c t a b l e u n d e r s o f t w a r e c o n t r o l t o a n y v a l u e f r o m t h e g r o u p 7 5 , 
1 5 0 , 3 0 0 , 1 2 0 0 , 2 4 0 0 , 4 8 0 0 , 9 6 0 0 o r 1 9 2 0 0 b a u d s ; t h e s p e e d s a r e 
a c c u r a t e t o w i t h i n 0 . 2 % . A s i m p l e h a n d s h a k i n g i n p u t i s p r o v i d e d 
w h i c h i n h i b i t s t h e s e r i a l o u t p u t w h e n n e g a t i v e a n d e n a b l e s i t w h e n 
p o s i t i v e ( R S 4 2 3 l e v e l s ) . I t i s a l s o p o s s i b l e f o r t h e u s e r t o 
p r o v i d e h i s o w n p r i n t e r d r i v e r s o f t w a r e t o i m p l e m e n t , f o r e x a m p l e , 
f o r m f e e d o r h a n d s h a k e u s i n g t h e r e v e r s e s e r i a l c h a n n e l . 


B a u d 
r a t e 
i s 
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PA R A L L E L P R I N T E R I N T E R FA C E ( M o d e l B o n l y ) 


A p a r a l l e l 
p r i n t e r 
o u t p u t 
t o 
C e n t r o n i c s 
s p e c i ﬁ c a t i o n s 
i s 


p r o v i d e d i n t h e M o d e l B M i c r o c o m p u t e r , u s i n g a 6 5 2 2 i n p u t / o u t p u t 
d e v i c e p l u s b u f f e r s . 


I t 
i s 
p o s s i b l e 
f o r 
t h e 
u s e r 
t o 
i n t e r c e p t 
t h e 
n o r m a l 
d r i v e r 


s o f t w a r e 
f o r 
t h e 
p a r a l l e l 
p r i n t e r 
s o 
a s 
t o 
a d d 
s p e c i a l 
f e a t u r e s 


s u c h 
a s 
s o f t w a r e 
f o r m - f e e d . 


FLOPPY DISC INTERFACE (Option) 


P r o v i s i o n 
i s 
m a d e 
o n 
t h e 
m a i n 
P C B 
t o 
ﬁ t 
a ﬂ o p p y 
d i s c 


c o n t r o l l e r 
p l u s 
d a t a 
s e p a r a t o r 
a n d 
b u f f e r 
d e v i c e s 
t o 
a l l o w 


i n t e r f a c i n g t o o n e o r t w o 5 . 2 5 " o r 8 " ﬂ o p p y d i s c d r i v e s . N e i t h e r 
t h e s e 
d e v i c e s 
n o r 
t h e 
c o n n e c t o r 
a r e 
ﬁ t t e d 
i n 
t h e 
M o d e l 
A m a c h i n e . 


T h e 
c o n n e c t o r 
a l o n e 
i s 
ﬁ t t e d 
i n 
t h e 
s t a n d a r d 
M o d e l 
B m a c h i n e . 


T h e d i s c c o n n e c t o r i s a 3 4 - w a y t y p e t o S A 4 0 0 s p e c i ﬁ c a t i o n b u t a l l 
c o n t r o l 
s i g n a l s 
a r e 
p r e s e n t 
t o 
a l l o w 
a n 
S A 8 0 0 
s p e c i ﬁ c a t i o n 


i n t e r f a c e t o b e i m p l e m e n t e d b y m e a n s o f a n a d a p t o r c a b l e . A l i n k 
o n 
t h e 
m a i n 
P C B 
s e l e c t s 
t h e 
a p p r o p r i a t e 
d a t a 
r a t e , 
i . e . 
1 2 5 


k b i t s / s e c 
f o r 
m i n i - ﬂ o p p y 
a n d 
2 5 0 
k b i t s / s e c 
f o r 
8 " 
ﬂ o p p y . 
T h e 


h a r d w a r e 
i s 
c a p a b l e 
o f 
s u p p o r t i n g 
8 " 
d i s c s 
t o 
t h e 
I B M 
3 7 4 0 


s p e c i ﬁ c a t i o n , b u t t h e s t a n d a r d D i s c O p e r a t i n g S y s t e m , p r e s e n t i n 
a n a d d i t i o n a l R O M n o t ﬁ t t e d i n t h e M o d e l A o r M o d e l B m a c h i n e s , 
w i l l s u p p o r t m i n i - ﬂ o p p y d i s c s o n l y . 


A N A L O G U E I N P U T S ( M o d e l B o n l y ) 


P r o v i s i o n 
i s 
m a d e 
o n 
t h e 
m a i n 
P C B 
t o 
ﬁ t 
a f o u r - c h a n n e l 
t w e l v e 


b i t 
a n a l o g u e 
t o 
d i g i t a l 
c o n v e r t e r 
d e v i c e 
t o 
w h i c h 
e x t e r n a l 
X - Y 


j o y s t i c k c o n t r o l s c a n b e c o n n e c t e d . T h e A D C a n d c o n n e c t o r a r e n o t 
ﬁ t t e d 
i n 
t h e 
M o d e l A m a c h i n e . 
T h e 
c o n n e c t o r 
i s 
a 1 5 - w a y 
D - t y p e 


w h i c h a l s o i n c l u d e s t h e l i g h t - p e n i n p u t ( q . v . ) . 


ECONET INTERFACE (Option) 


P r o v i s i o n 
i s 
m a d e 
o n 
t h e 
m a i n 
P C B 
t o 
ﬁ t 
a 6 8 5 4 
I / O 
d e v i c e 


p l u s b u f f e r i n g t o i m p l e m e n t a n A c o r n v e r s i o n 3 . 0 E c o n e t i n t e r f a c e . 
T h e s e 
d e v i c e s 
a r e 
n o t 
ﬁ t t e d 
i n 
t h e 
M o d e l 
A o r 
t h e 
M o d e l 
B 


m a c h i n e s . 


PROCESSOR BUS INTERFACE ("TUBE") (Model Bonly) 


U n - b u f f e r e d a d d r e s s , d a t a a n d c o n t r o l s i g n a l s a r e a v a i l a b l e o n 


a 4 0 - w a y 
c o n n e c t o r 
t o 
p r o v i d e 
a h i g h - s p e e d 
i n t e r f a c e 
t o 
a n 


e x t e r n a l l a n g u a g e p r o c e s s o r ( e . g . 
i n t e r f a c e 
i s 
s u i t a b l e 
o n l y 
f o r 
t h i s 


l e n g t h o f r i b b o n c a b l e a s i n t e r c o n n e c t i o n b e t w e e n 
T h e 
c o n n e c t o r 
i s 
n o t 
ﬁ t t e d 
i n 
t h e 
M o d e l 
A m a c h i n e . 


t h e 
Z 8 0 
C P / M 
o p t i o n ) . 
T h e 


p u r p o s e a n d u s e s a s h o r t 


t h e 
t w o 
u n i t s . 


( C ) C o p y r i g h t B B C S e p t e m b e r 1 9 8 2 P a g e 3 4 


1 M H z B U S I N T E R FA C E ( M o d e l B o n l y ) 


A b u f f e r e d p r o c e s s o r b u s i n t e r f a c e i s p r o v i d e d f o r c o n n e c t i o n 


t o 
o t h e r 
i t e m s 
s u c h 
a s 
t h e 
t e l e t e x t 
r e c e i v e r / d a t a 
g r a b b e r . 


I n t e r c o n n e c t i o n b e t w e e n t h e m a i n m a c h i n e a n d t h e e x t e n s i o n s i s b y 
m e a n s o f r i b b o n c a b l e h a v i n g a l t e r n a t e g r o u n d c o n d u c t o r s , a l l o w i n g 
a c a b l e l e n g t h o f a t l e a s t 3 0 c m . T h e c o n n e c t o r i s n o t ﬁ t t e d i n 
t h e 
M o d e l 
A m a c h i n e . 


S O U N D 
G E N E R A T O R 


A l o u d s p e a k e r i s ﬁ t t e d i n t h e M o d e l A a n d M o d e l B m a c h i n e s a s 


T h i s i s f e d f r o m a t h r e e - v o i c e s o u n d - g e n e r a t o r d e v i c e 


t o n e s , 
m u s i c 
a n d 
n o i s e 


s t a n d a r d , 
c a p a b l e 
o f 
p r o d u c i n g 


c o n t r o l . 


u n d e r 
s o f t w a r e 


U S E R I N P U T / O U T P U T ( M o d e l B o n l y ) 


A T T L - c o m p a t i b l e 8 - b i t p o r t p l u s 2 c o n t r o l b i t s i s p r o v i d e d i n 


t h e M o d e l B m a c h i n e f o r u s e r i n p u t / o u t p u t . 


L I G H T- P E N I N P U T ( M o d e l B o n l y ) 


A n i n p u t i s p r o v i d e d w h i c h a l l o w s t h e c o n n e c t i o n o f a s i m p l e 


l i g h t - p e n , f e d t o t h e 6 8 4 5 C R T c o n t r o l l e r , 
s a m e c o n n e c t o r a s t h e a n a l o g u e i n p u t s , 
n o t s u p p l i e d . 


T h i s 
i n p u t 
u s e s 
t h e 


T h e 
l i g h t 
p e n 
i t s e l f 
i s 


V D U 
S C R E E N 
F O R M A T S 


T h e r e 
a r e 
8 s e l e c t a b l e 
d i s p l a y 
f o r m a t s 
a s 


r e q u i r e m e n t s i n b y t e s a r e s h o w n i n b r a c k e t s ) ; 


f o l l o w s 
(RAM 


6 4 0 * 2 5 6 2 - c o l o u r g r a p h i c s & 8 0 * 3 2 t e x t . 
3 2 0 * 2 5 6 4 - c o l o u r g r a p h i c s & 4 0 * 3 2 t e x t . 
1 6 0 * 2 5 6 1 6 - c o l o u r g r a p h i c s a n d 2 0 * 3 2 t e x t . 
8 0 * 2 5 
2 - c o l o u r 
t e x t 


3 2 0 * 2 5 6 2 - c o l o u r g r a p h i c s & 4 0 * 3 2 t e x t . 
1 6 0 * 2 5 6 4 - c o l o u r g r a p h i c s & 2 0 * 3 2 t e x t . 
4 0 * 2 5 
2 - c o l o u r 
t e x t . 


4 0 * 2 5 t e l e t e x t - c o m p a t i b l e d i s p l a y . 


0 . 
( 2 0 K ) 
( 2 0 K ) 
( 2 0 K ) 
( 1 6 K ) 
( l O K ) 
( l O K ) 


1 . 
2 . 
3 . 
4 . 


5 . 
6 . 
( 8 K ) 


7 . 
( I K ) 


c h a r a c t e r s 
d i s p l a y e d 
i n 
m o d e s 
0 t o 
6 a r e 


t h e 
" c h a r a c t e r 


t h e 
o p e r a t i n g 
s y s t e m 
R O M . 
T h e s e 


( w i t h 
o n e - l i n e 
d e s c e n d e r s ) . 
I n 


d i s p l a y m o d e s 3 a n d 6 t h e r e a r e f o r c e d g a p s b e t w e e n c h a r a c t e r r o w s 
a n d 
t h e r e f o r e 
c o n t i n u o u s 
v e r t i c a l 
l i n e s 
( o n 
f o r m s 
e t c . ) 
a r e 
n o t 


p o s s i b l e . T h e c h a r a c t e r s e t i s A S C I I w i t h t h e e x c e p t i o n t h a t c o d e 


T h e a l p h a n u m e r i c 


g e n e r a t e d 
i n 


g e n e r a t o r " 
c h a r a c t e r s 
a r e 
o n 
a n 
8 * 8 
m a t r i x 


h i g h - r e s o l u t i o n 


b e i n g 
p a r t 
o f 


g r a p h i c s 
w i t h 
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6 / 0 g i v e s a p o u n d s i g n . 


I n m o d e s 0 t o 6 t h e " c o l o u r s " a r e s e l e c t a b l e f r o m a p a l e t t e o f 


16 effects being black, red, green, yellow, blue, magenta, cyan, 
white and the same eight colours automatically ﬂashing. 


M o d e 7 u s e s a t e l e t e x t c h a r a c t e r g e n e r a t o r t o p r o v i d e a f u l l 


t e l e t e x t / p r e s t e l 
d o u b l e - h e i g h t , 
8 


c o n t i g u o u s g r a p h i c s , h e l d g r a p h i c s , ﬂ a s h e t c . 


circuitry to generate all these display modes is present 


in the Model Amachine, but it is not possible to use display 
m o d e s 0 t o 3 u n l e s s t h e 1 6 K R A M e x p a n s i o n o p t i o n i s ﬁ t t e d . 


All display modes use nominally 40us active horizontal display 


p e r i o d a n d 2 5 6 l i n e s p e r ﬁ e l d a c t i v e v e r t i c a l p e r i o d , i . e . 7 7 % 
a n d 8 9 % r e s p e c t i v e l y o f t h e n o m i n a l T V d i s p l a y a r e a . 


P r o c e s s o r a c c e s s t o t h e d i s p l a y r e f r e s h R A M i s t o t a l l y 


t r a n s p a r e n t a n d t h e d i s p l a y i s t h e r e f o r e c o m p l e t e l y g l i t c h - f r e e . 


f o r m a t d i s p l a y i n c l u d i n g c h a r a c t e r r o u n d i n g , 
d i s p l a y c o l o u r s , 8 b a c k g r o u n d c o l o u r s , n o n - 


T h e 


C E N T R A L P R O C E S S O R 


The CPU is a6502A running at a2MHz clock 


a c c e s s i n g s o m e i n p u t - o u t p u t d e v i c e s , w h e n 
f r e q u e n c y i s r e d u c e d t o I M H z . 


r a t e 
e x c e p t 
w h e n 


t h e 
e f f e c t i v e 
c l o c k 


M E M O R Y 


The Model Amachine is equipped with 16 Kbytes dynamic random- 


access-memory (5v type), 16 Kbytes operating system ROM (character 
generator, input/output handlers, cassette operating system etc.) 
a n d 1 6 K b y t e s l a n g u a g e R O M ( B A S I C i n t e r p r e t e r ) . 
capable of expansion to 32 Kbytes and the ROM to 80 Kbytes (being 
a n o t h e r 1 6 K b y t e l a n g u a g e R O M 
Kbytes of ROM/EPROM containing applications 
one of the language ROMs, or the ROM/EPROM, can be enabled at any 
g i v e n t i m e u n d e r s o f t w a r e c o n t r o l ) . 


T h e 
R A M 
i s 


e . g . 
P a s c a l 
- p l u s 
u p 
t o 
3 2 


s o f t w a r e e t c . O n l y 


RADIO FREQUENCY INTERFERENCE 


T h e 
l e v e l 
o f 
R . F . 


m i n i m i s e d . 


r a d i a t i o n 
f r o m 
t h e 
m a c h i n e 
h a s 
b e e n 
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© B B C 1 9 8 1 


f 8 
f 9 
f 3 
f 4 
f 5 
f 6 
f 7 
f 1 
f 2 
f O 


) 
% 
& 
$ 
I 
■ 
# 


✓ 


4 
E S C A P E 
A 
\ 
0 
9 
8 
5 
6 
7 
3 
2 
4 
1 


{ 
£ 
p a ) 


' f ' 
Q 
T 
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